From 94aa662138576c22deef1642b3b2b302ad075a82 Mon Sep 17 00:00:00 2001 From: Archaic Date: Mon, 26 Dec 2005 19:46:12 +0000 Subject: Reverting UTF-8 changes until everything is in place. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7236 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter06/man.xml | 180 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 180 insertions(+) (limited to 'chapter06/man.xml') diff --git a/chapter06/man.xml b/chapter06/man.xml index e69de29bb..371985d2e 100644 --- a/chapter06/man.xml +++ b/chapter06/man.xml @@ -0,0 +1,180 @@ + + + %general-entities; +]> + +Man-&man-version; + + +Man + + +<para>The Man package contains programs for finding and viewing man pages.</para> + +<segmentedlist> +<segtitle>&buildtime;</segtitle> +<segtitle>&diskspace;</segtitle> +<seglistitem><seg>0.1 SBU</seg><seg>1.3 MB</seg></seglistitem> +</segmentedlist> + +<segmentedlist> +<segtitle>&dependencies;</segtitle> +<seglistitem><seg>Bash, Binutils, Coreutils, Gawk, GCC, +Glibc, Grep, Make, and Sed</seg></seglistitem> +</segmentedlist> +</sect2> + +<sect2 role="installation"> +<title>Installation of Man + +Two adjustments need to be made to the sources of Man. + +The first is a sed substitution to add the +-R switch to the PAGER +variable so that escape sequences are properly handled by Less: + +sed -i 's@-is@&R@g' configure + +The second is also a sed substitution to comment out the +MANPATH /usr/man line in the +man.conf file to prevent redundant results when +using programs such as whatis: + +sed -i 's@MANPATH./usr/man@#&@g' src/man.conf.in + +Prepare Man for compilation: + +./configure -confdir=/etc + +The meaning of the configure options: + + + +-confdir=/etc +This tells the man program to look for the +man.conf configuration file in the /etc directory. + + + +Compile the package: + +make + +This package does not come with a test suite. + +Install the package: + +make install + +If you will be working on a terminal that does not support text +attributes such as color and bold, you can disable Select Graphic Rendition +(SGR) escape sequences by editing the man.conf file and +adding the -c option to the NROFF +variable. If you use multiple terminal types for one computer it may be better +to selectively add the GROFF_NO_SGR environment variable for the +terminals that do not support SGR. + +If the character set of the locale uses 8-bit characters, search for the +line beginning with NROFF in /etc/man.conf, +and verify that it matches the following: + +NROFF /usr/bin/nroff -Tlatin1 -mandoc + +Note that latin1 should be used even if it is not +the character set of the locale. The reason is that, according to the +specification, groff has no means of typesetting +characters outside International Organization for Standards +(ISO) 8859-1 without some strange escape codes. When formatting man +pages, groff thinks that they are in the ISO 8859-1 +encoding and this -Tlatin1 switch tells +groff to use the same encoding for output. Since +groff does no recoding of input characters, the +formatted result is really in the same encoding as input, and therefore +it is usable as the input for a pager. + +This does not solve the problem of a non-working +man2dvi program for localized man pages in +non-ISO 8859-1 locales. Also, it does not work with multibyte +character sets. The first problem does not currently have a solution. +The second issue is not of concern because the LFS installation does +not support multibyte character sets. + +Additional information with regards to the compression of +man and info pages can be found in the BLFS book at +. + + + + +Contents of Man + + +Installed programs +apropos, makewhatis, man, +man2dvi, man2html, and whatis + + +Short Descriptions + + + + +apropos + +Searches the whatis database and displays the short descriptions +of system commands that contain a given string +apropos + + + + +makewhatis + +Builds the whatis database; it reads all the man pages +in the MANPATH and writes the name and a short description in the +whatis database for each page +makewhatis + + + + +man + +Formats and displays the requested on-line man page +man + + + + +man2dvi + +Converts a man page into dvi format +man2dvi + + + + +man2html + +Converts a man page into HTML +man2html + + + + +whatis + +Searches the whatis database and displays the short descriptions +of system commands that contain the given keyword as a separate +word +whatis + + + + + + + + -- cgit v1.2.3-54-g00ecf