diff options
Diffstat (limited to 'chapter06/man-inst.xml')
| -rw-r--r-- | chapter06/man-inst.xml | 48 |
1 files changed, 41 insertions, 7 deletions
diff --git a/chapter06/man-inst.xml b/chapter06/man-inst.xml index f07ee1615..4a639b329 100644 --- a/chapter06/man-inst.xml +++ b/chapter06/man-inst.xml @@ -1,22 +1,56 @@ +<sect2><title> </title><para> </para></sect2> + <sect2> <title>Installation of Man</title> -<para>Run the following commands to install man:</para> -<para><screen><userinput>patch -Np1 -i ../man-&man-80cols-patch-version;-80cols.patch && + +<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 && -make && -make install</userinput></screen></para> + ./configure -default -confdir=/etc +</userinput></screen></para> + +<para>Continue with compiling the package:</para> + +<para><screen><userinput>make</userinput></screen></para> + +<para>And finish off installing the package:</para> + +<para><screen><userinput>make install</userinput></screen></para> -<para>Note: If you wish to disable SGR escape sequences, you should +<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> +to nroff.</para></note> <para>You may want to take a look at the man hint at <ulink url="&hints-root;man.txt"/>, which deals with formatting 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> + |