- Document new manpage variables

svn path=/head/; revision=29479

en_US.ISO8859-1/books/porters-handbook/book.sgml

@@ -3639,6 +3639,21 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
 	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>${PREFIX}/man/man1/foo.1.gz
+${PREFIX}/man/de/man1/foo.1.gz
+${PREFIX}/man/ja/man1/foo.1.gz
+${PREFIX}/man/man1/bar.1.gz
+${PREFIX}/man/de/man3/baz.3.gz</programlisting>
     </sect1>
 
     <sect1 id="makefile-info">