diff options
Diffstat (limited to 'chapter06/man-inst.xml')
| -rw-r--r-- | chapter06/man-inst.xml | 55 |
1 files changed, 27 insertions, 28 deletions
diff --git a/chapter06/man-inst.xml b/chapter06/man-inst.xml index 4a639b329..6b9455681 100644 --- a/chapter06/man-inst.xml +++ b/chapter06/man-inst.xml @@ -3,17 +3,37 @@ <sect2> <title>Installation of Man</title> +<para>There are three patches for Man. The first patch comments out one of the +lines in the <filename>man.conf</filename> file (MANPATH /usr/man) to +prevent redundant results when using programs such as +<userinput>whatis</userinput>:</para> +<para><screen><userinput>patch -Np1 -i ../man-&man-manpath-patch-version;-manpath.patch</userinput></screen></para> + +<para>The second patch adds the <emphasis>-R</emphasis> option to the +<emphasis>PAGER</emphasis> variable so that escape sequences are +handled properly:</para> + +<para><screen><userinput>patch -Np1 -i ../man-&man-pager-patch-version;-pager.patch</userinput></screen></para> + +<para>The last patch prevents problem when man pages not formatted +with more than 80 columns are used in conjunction with recent releases +of <userinput>groff</userinput>:</para> + +<para><screen><userinput>patch -Np1 -i ../man-&man-80cols-patch-version;-80cols.patch</userinput></screen></para> + +<para>The paths to some programs are written into man's files. +Unfortunately, the configure script picks the last location in PATH +rather than the first place a program is found. By appending +<emphasis>/usr/bin:/bin</emphasis> to PATH for the +<userinput>./configure</userinput> command, we ensure that man doesn't +use the programs in the <filename class="directory">/static</filename> +directory.</para> <para>Prepare Man to be compiled:</para> -<para><screen><userinput> -patch -Np1 -i ../man-&man-80cols-patch-version;-80cols.patch && -patch -Np1 -i ../man-&man-manpath-patch-version;-manpath.patch && -patch -Np1 -i ../man-&man-pager-patch-version;-pager.patch && -PATH=$PATH:/usr/bin:/bin \ - ./configure -default -confdir=/etc -</userinput></screen></para> +<para><screen><userinput>PATH=$PATH:/usr/bin:/bin \ + ./configure -default -confdir=/etc</userinput></screen></para> <para>Continue with compiling the package:</para> @@ -33,24 +53,3 @@ and compression issues for man pages.</para> </sect2> -<sect2> -<title>Command explanations</title> - -<para><userinput>patch...:</userinput> -These three patches comment out one of the lines in the -<filename>man.conf</filename> file (MANPATH /usr/man) because it will create -redundant results when using programs like <userinput>whatis</userinput>. -It also adds the <emphasis>-R</emphasis> option to the -<emphasis>PAGER</emphasis> variable so man pages are displayed properly. -Lastly, the patch fixes the problem where man pages are not formatted with -more than 80 columns when used with the recent groff versions.</para> - -<para><userinput>PATH=$PATH:/usr/bin:/bin ./configure -default</userinput>: -The paths to some programs get written into man's files. Unfortunately, the -configure script picks the last location in PATH rather than the first -where a program is found. By appending /usr/bin:/bin to PATH for the -./configure command, we make sure that man doesn't use the /static versions -of our programs.</para> - -</sect2> - |