svn commit: r43051 - head/en_US.ISO8859-1/books/porters-handbook

[Eitan Adler]

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">