Merging caption and installation sections for all packages in chapters 5 and 6.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3052 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

1 files changed, 62 insertions, 1 deletions

diff --git a/chapter06/man.xml b/chapter06/man.xml
index 9c0cd7978..833ff0e8e 100644
--- a/chapter06/man.xml
+++ b/chapter06/man.xml
@@ -7,7 +7,68 @@ Estimated required disk space:  &man-compsize;</screen>
 
 &aa-man-shortdesc;
 &aa-man-dep;
-&c6-man-inst;
+
+<sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
+
+<sect2>
+<title>Installation of Man</title>
+
+<para>We'll make three adjustments to the sources of Man.</para>
+ 
+<para>The first patch comments out the "MANPATH /usr/man" line in the
+<filename>man.conf</filename> file to prevent redundant results when using
+ programs such as <userinput>whatis</userinput>:</para>
+
+<screen><userinput>patch -Np1 -i ../&man-manpath-patch;</userinput></screen>
+
+<para>The second patch adds the <emphasis>-R</emphasis> option to the
+<emphasis>PAGER</emphasis> variable so that escape sequences are
+handled properly:</para>
+
+<screen><userinput>patch -Np1 -i ../&man-pager-patch;</userinput></screen>
+
+<para>The third and last patch prevents a problem when man pages not formatted
+with more than 80 columns are used in conjunction with recent releases of
+<userinput>groff</userinput>:</para>
+
+<screen><userinput>patch -Np1 -i ../&man-80cols-patch;</userinput></screen>
+
+<para>Now prepare Man for compilation:</para>
+
+<screen><userinput>./configure -default -confdir=/etc</userinput></screen>
+
+<para>The meaning of the configure options:</para>
+
+<itemizedlist>
+<listitem><para><userinput>-default</userinput>: This tells the configure script
+to select a sensible set of default options. For example: only English man
+pages, no message catalogs, man not suid, handle compressed man pages, compress
+cat pages, create cat pages whenever the appropriate directory exists, follow
+FHS by putting cat pages under /var/cache/man provided that that directory
+exists.</para></listitem>
+
+<listitem><para><userinput>-confdir=/etc</userinput>: This tells the
+<userinput>man</userinput> program to look for the <filename>man.conf</filename>
+configuration file in the <filename>/etc</filename> directory.</para></listitem>
+</itemizedlist>
+
+<para>Compile the package:</para>
+
+<screen><userinput>make</userinput></screen>
+
+<para>And install it:</para>
+
+<screen><userinput>make install</userinput></screen>
+
+<note><para>If you wish to disable SGR escape sequences, you should
+edit the man.conf file and add the <userinput>-c</userinput> argument
+to nroff.</para></note>
+
+<para>You may want to also take a look at the BLFS page at
+<ulink url="&blfs-root;view/cvs/postlfs/compressdoc.html"/> which deals with
+formatting and compression issues for man pages.</para>
+
+</sect2>
 
 </sect1>