aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/man.xml
diff options
context:
space:
mode:
authorManuel Canales Esparcia <manuel@linuxfromscratch.org>2004-12-21 19:38:32 +0000
committerManuel Canales Esparcia <manuel@linuxfromscratch.org>2004-12-21 19:38:32 +0000
commit3f0c882398e626cd92503b1bd964a32e89f818dc (patch)
tree73e2935fe138615f4ec2d430fb7fbf6ae8fa9a80 /chapter06/man.xml
parentaaa3260c039e40d68545922b64199b039da6af7b (diff)
Removed the text in chapter 06.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@4446 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/man.xml')
-rw-r--r--chapter06/man.xml129
1 files changed, 4 insertions, 125 deletions
diff --git a/chapter06/man.xml b/chapter06/man.xml
index 01c8c9c5d..5067eb177 100644
--- a/chapter06/man.xml
+++ b/chapter06/man.xml
@@ -10,7 +10,6 @@
<indexterm zone="ch-system-man"><primary sortas="a-Man">Man</primary></indexterm>
<sect2 role="package"><title/>
-<para>The Man package contains programs for finding and viewing manual pages.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
@@ -18,33 +17,20 @@
<seglistitem><seg>0.1 SBU</seg><seg>1.9MB</seg></seglistitem>
</segmentedlist>
-<segmentedlist>
-<segtitle>Man installation depends on</segtitle>
-<seglistitem><seg>Bash, Binutils, Coreutils, Gawk, GCC,
-Glibc, Grep, Make, Sed</seg></seglistitem>
-</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Man</title>
-<para>We'll make three adjustments to the sources of Man.</para>
-
-<para>The first is a patch which allows Man to work better with recent releases
-of Groff. In particular, man pages will now display using the full terminal
-width instead of being limited to 80 characters:</para>
+<para>Apply a patch:</para>
<screen><userinput>patch -Np1 -i ../man-&man-version;-80cols-1.patch</userinput></screen>
-<para>The second is a sed substitution to add the <parameter>-R</parameter>
-switch to the <emphasis>PAGER</emphasis> variable so that escape sequences are
-properly handled by Less:</para>
+<para>Issue a sed substitution:</para>
<screen><userinput>sed -i 's@-is@&amp;R@g' configure</userinput></screen>
-<para>The third is also a sed substitution to comment out the <quote>MANPATH
-/usr/man</quote> line in the <filename>man.conf</filename> file to prevent
-redundant results when using programs such as <command>whatis</command>:</para>
+<para>Issue another sed substitution:</para>
<screen><userinput>sed -i 's@MANPATH./usr/man@#&amp;@g' src/man.conf.in</userinput></screen>
@@ -52,17 +38,6 @@ redundant results when using programs such as <command>whatis</command>:</para>
<screen><userinput>./configure -confdir=/etc</userinput></screen>
-<para>The meaning of the configure options:</para>
-
-<variablelist>
-<varlistentry>
-<term><parameter>-confdir=/etc</parameter></term>
-<listitem><para>This tells the
-<command>man</command> program to look for the <filename>man.conf</filename>
-configuration file in the <filename class="directory">/etc</filename> directory.</para></listitem>
-</varlistentry>
-</variablelist>
-
<para>Compile the package:</para>
<screen><userinput>make</userinput></screen>
@@ -71,108 +46,12 @@ configuration file in the <filename class="directory">/etc</filename> directory.
<screen><userinput>make install</userinput></screen>
-<note><para>If you wish to disable SGR (Select Graphic Rendition) escape sequences, you should edit the
-<filename>man.conf</filename> file and add the <parameter>-c</parameter> switch
-to NROFF.</para></note>
-
-<para>If your character set uses 8-bit characters, search for the line
-beginning with <quote>NROFF</quote> in <filename>/etc/man.conf</filename>, and verify that it coincides
-with the following:</para>
-
-<screen>NROFF /usr/bin/nroff -Tlatin1 -mandoc</screen>
-
-<para>Note that you should use <quote>latin1</quote> even if it is not the character set
-of your locale. The reason is that,
-according to the specification, <application>groff</application> has
-no means of typesetting characters outside ISO-8859-1
-without some strange escape codes, and localized manual
-pages are therefore really a hack. When formatting manual pages,
-<application>groff</application> thinks that they are in the ISO-8859-1
-encoding and this <parameter>-Tlatin1</parameter> switch tells
-<application>groff</application> to use the same encoding for output.
-Since <application>groff</application> does no recoding of input characters,
-the formatted result is really in the same encoding as input (although
-<application>groff</application> doesn't know that it is not ISO-8859-1)
-and therefore it is usable as the input for a pager.</para>
-
-<para>Of course, this hack does not solve the problem of non-working
-<command>man2dvi</command> program for localized manual
-pages in non-ISO-8859-1 locales.
-Also, it does not work at all with multibyte character sets.
-The first problem does not have a solution currently. The second
-one is not of a concern because the LFS installation does not support
-multibyte character sets properly anyway. You may want to look at
-internationalization related hints, though.</para>
-
-<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>
<sect2 id="contents-man" role="content"><title>Contents of Man</title>
-<segmentedlist>
-<segtitle>Installed programs</segtitle>
-<seglistitem><seg>apropos, makewhatis, man,
-man2dvi, man2html and whatis</seg></seglistitem>
-</segmentedlist>
-
-<variablelist><title>Short descriptions</title>
-
-<varlistentry id="apropos">
-<term><command>apropos</command></term>
-<listitem>
-<indexterm zone="ch-system-man apropos"><primary sortas="b-apropos">apropos</primary></indexterm>
-<para>searches the whatis database and displays
-the short descriptions of system commands that contain a given string.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry id="makewhatis">
-<term><command>makewhatis</command></term>
-<listitem>
-<indexterm zone="ch-system-man makewhatis"><primary sortas="b-makewhatis">makewhatis</primary></indexterm>
-<para>builds the whatis database. It reads
-all the manual pages in the manpath and for each page writes the name and a
-short description in the whatis database.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry id="man">
-<term><command>man</command></term>
-<listitem>
-<indexterm zone="ch-system-man man"><primary sortas="b-man">man</primary></indexterm>
-<para>formats and displays the requested on-line manual page.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry id="man2dvi">
-<term><command>man2dvi</command></term>
-<listitem>
-<indexterm zone="ch-system-man man2dvi"><primary sortas="b-man2dvi">man2dvi</primary></indexterm>
-<para>converts a manual page into dvi format.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry id="man2html">
-<term><command>man2html</command></term>
-<listitem>
-<indexterm zone="ch-system-man man2html"><primary sortas="b-man2html">man2html</primary></indexterm>
-<para>converts a manual page into html.</para>
-</listitem>
-</varlistentry>
-
-<varlistentry id="whatis">
-<term><command>whatis</command></term>
-<listitem>
-<indexterm zone="ch-system-man whatis"><primary sortas="b-whatis">whatis</primary></indexterm>
-<para>searches the whatis database and displays the short descriptions of system
-commands that contain the given keyword as a separate word.</para>
-</listitem>
-</varlistentry>
-</variablelist>
+<para>See testing</para>
</sect2>