Date: Mon, 28 Oct 2013 19:01:24 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43051 - head/en_US.ISO8859-1/books/porters-handbook Message-ID: <201310281901.r9SJ1OWE090460@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: eadler Date: Mon Oct 28 19:01:24 2013 New Revision: 43051 URL: http://svnweb.freebsd.org/changeset/doc/43051 Log: man pages are just regular files now so do not expend an entire section just for them. Leave the paragraph describing MAN*PREFIX for now. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 18:58:13 2013 (r43050) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 19:01:24 2013 (r43051) @@ -4135,38 +4135,6 @@ MASTERDIR= ${.CURDIR}/../xdvi300 <sect1 id="makefile-manpages"> <title>Man Pages</title> - - <para>The <makevar>MAN[1-9LN]</makevar> variables will - automatically add any manpages to - <filename>pkg-plist</filename> (this means you must - <emphasis>not</emphasis> list manpages in the - <filename>pkg-plist</filename>—see - <link linkend="plist-sub">generating PLIST</link> for more). - It also makes the install stage automatically compress or - uncompress manpages depending on the setting of - <makevar>NO_MANCOMPRESS</makevar> in - <filename>/etc/make.conf</filename>.</para> - - <para>If your port tries to install multiple names for manpages - using symlinks or hardlinks, you must use the - <makevar>MLINKS</makevar> variable to identify these. The - link installed by your port will be destroyed and recreated by - <filename>bsd.port.mk</filename> to make sure it points to the - correct file. Any manpages listed in MLINKS must not be - listed in the <filename>pkg-plist</filename>.</para> - - <para>To specify whether the manpages are compressed upon - installation, use the <makevar>MANCOMPRESSED</makevar> - variable. This variable can take three values, - <literal>yes</literal>, <literal>no</literal> and - <literal>maybe</literal>. <literal>yes</literal> means - manpages are already installed compressed, - <literal>no</literal> means they are not, and - <literal>maybe</literal> means the software already respects - the value of <makevar>NO_MANCOMPRESS</makevar> so - <filename>bsd.port.mk</filename> does not have to do anything - special.</para> - <para>If your port anchors its man tree somewhere other than <makevar>PREFIX</makevar>, you can use the <makevar>MANPREFIX</makevar> to set it. Also, if only @@ -4177,54 +4145,6 @@ MASTERDIR= ${.CURDIR}/../xdvi300 (where <replaceable>sect</replaceable> is one of <literal>1-9</literal>, <literal>L</literal> or <literal>N</literal>).</para> - - <para>If your manpages go to language-specific subdirectories, - set the name of the languages to <makevar>MANLANG</makevar>. - The value of this variable defaults to <literal>""</literal> - (i.e., English only).</para> - - <para>Here is an example that puts it all together.</para> - - <programlisting>MAN1= foo.1 -MAN3= bar.3 -MAN4= baz.4 -MLINKS= foo.1 alt-name.8 -MANLANG= "" ja -MAN3PREFIX= ${PREFIX}/share/foobar -MANCOMPRESSED= yes</programlisting> - - <para>This states that six files are installed by this - port;</para> - - <programlisting>${MANPREFIX}/man/man1/foo.1.gz -${MANPREFIX}/man/ja/man1/foo.1.gz -${PREFIX}/share/foobar/man/man3/bar.3.gz -${PREFIX}/share/foobar/man/ja/man3/bar.3.gz -${MANPREFIX}/man/man4/baz.4.gz -${MANPREFIX}/man/ja/man4/baz.4.gz</programlisting> - - <para>Additionally - <filename>${MANPREFIX}/man/man8/alt-name.8.gz</filename> may - or may not be installed by your port. Regardless, a symlink - will be made to join the foo(1) manpage and alt-name(8) - manpage.</para> - - <para>If only some manpages are translated, you can use several - variables dynamically created from <makevar>MANLANG</makevar> - content:</para> - - <programlisting>MANLANG= "" de ja -MAN1= foo.1 -MAN1_EN= bar.1 -MAN3_DE= baz.3</programlisting> - - <para>This translates into this list of files:</para> - - <programlisting>${MANPREFIX}/man/man1/foo.1.gz -${MANPREFIX}/man/de/man1/foo.1.gz -${MANPREFIX}/man/ja/man1/foo.1.gz -${MANPREFIX}/man/man1/bar.1.gz -${MANPREFIX}/man/de/man3/baz.3.gz</programlisting> </sect1> <sect1 id="makefile-info">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310281901.r9SJ1OWE090460>