gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 11:49:20 +01:00
Code Issues Packages Projects Releases Wiki Activity

Indenting chapter 6, part 8

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7358 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-06 20:45:42 +00:00
parent cf7142a5e2
commit 2fa922f380
6 changed files with 941 additions and 648 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

317
chapter06/man-db.xml
View File

@ -1,28 +1,44 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-man-db" role="wrap"> <sect1 id="ch-system-man-db" role="wrap">
<title>Man-DB-&man-db-version;</title>
<?dbhtml filename="man-db.html"?> <?dbhtml filename="man-db.html"?>
<indexterm zone="ch-system-man-db"><primary sortas="a-Man-DB">Man-DB</primary></indexterm> <title>Man-DB-&man-db-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-man-db">
<para>The Man-DB package contains programs for finding and viewing man pages.</para> <primary sortas="a-Man-DB">Man-DB</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Man-DB package contains programs for finding and viewing man
pages.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>1.1 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>1.1 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Berkeley DB, Binutils, Coreutils, Gawk, GCC,
Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Berkeley DB, Binutils, Coreutils, Gawk, GCC, Gettext,
Glibc, Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -40,10 +56,10 @@ mv man/it{_IT.88591,} &amp;&amp;
mv man/ja{_JP.eucJP,} &amp;&amp; mv man/ja{_JP.eucJP,} &amp;&amp;
sed -i 's,\*_\*,??,' man/Makefile.in</userinput></screen> sed -i 's,\*_\*,??,' man/Makefile.in</userinput></screen>
<para>The second change is a <command>sed</command> substitution to delete the <para>The second change is a <command>sed</command> substitution to delete
<quote>/usr/man</quote> lines in the the <quote>/usr/man</quote> lines in the <filename>man_db.conf</filename>
<filename>man_db.conf</filename> file to prevent redundant results when file to prevent redundant results when using programs such as
using programs such as <command>whatis</command>:</para> <command>whatis</command>:</para>
<screen><userinput>sed -i '/\t\/usr\/man/d' src/man_db.conf.in</userinput></screen> <screen><userinput>sed -i '/\t\/usr\/man/d' src/man_db.conf.in</userinput></screen>
@ -57,34 +73,39 @@ to find at runtime, but that haven't been installed yet:</para>
#define GRAP "/usr/bin/grap"</literal> #define GRAP "/usr/bin/grap"</literal>
EOF</userinput></screen> EOF</userinput></screen>
<para>The <command>col</command> program is a part of the Util-linux package, <para>The <command>col</command> program is a part of the Util-linux
<command>lynx</command> is a text-based web browser package, <command>lynx</command> is a text-based web browser (see BLFS
(see BLFS for installation instructions), for installation instructions), <command>vgrind</command> converts
<command>vgrind</command> converts program sources to Groff input, program sources to Groff input, and <command>grap</command> is useful
and <command>grap</command> is useful for typesetting graphs in Groff documents. for typesetting graphs in Groff documents. The <command>vgrind</command>
The <command>vgrind</command> and <command>grap</command> programs are and <command>grap</command> programs are not normally needed for viewing
not normally needed for viewing manual pages. They are manual pages. They are not part of LFS or BLFS, but you should be able
not part of LFS or BLFS, but you should be able to install them yourself to install them yourself after finishing LFS if you wish to do so.</para>
after finishing LFS if you wish to do so.</para>
<para>Prepare Man-DB for compilation:</para> <para>Prepare Man-DB for compilation:</para>
<screen><userinput>./configure --prefix=/usr --enable-mb-groff --disable-setuid</userinput></screen> <screen><userinput>./configure --prefix=/usr --enable-mb-groff --disable-setuid</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--enable-mb-groff</parameter></term> <term><parameter>--enable-mb-groff</parameter></term>
<listitem><para>This tells the <command>man</command> program to <listitem>
use the <quote>ascii8</quote> and <quote>nippon</quote> Groff devices for formatting non-ISO-8859-1 <para>This tells the <command>man</command> program to use the
manual pages.</para></listitem> <quote>ascii8</quote> and <quote>nippon</quote> Groff devices for
formatting non-ISO-8859-1 manual pages.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>--disable-setuid</parameter></term> <term><parameter>--disable-setuid</parameter></term>
<listitem><para>This disables making the <command>man</command> program <listitem>
setuid to user <quote>man</quote>.</para></listitem> <para>This disables making the <command>man</command> program setuid
to user <systemitem class="username">man</systemitem>.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -101,7 +122,8 @@ man and info pages can be found in the BLFS book at
</sect2> </sect2>
<sect2><title>Non-English Manual Pages in LFS</title> <sect2>
<title>Non-English Manual Pages in LFS</title>
<para>Linux distributions have different policies concerning the character <para>Linux distributions have different policies concerning the character
encoding in which manual pages are stored in the filesystem. E.g., RedHat encoding in which manual pages are stored in the filesystem. E.g., RedHat
@ -114,63 +136,146 @@ language codes and the expected encoding of manual pages is listed below.
Man-DB automatically converts them to the locale encoding while viewing.</para> Man-DB automatically converts them to the locale encoding while viewing.</para>
<!-- Origin: man-db-2.4.3/src/encodings.c --> <!-- Origin: man-db-2.4.3/src/encodings.c -->
<table frame='all'><title>Expected character encoding of manual pages</title> <table>
<tgroup cols='2' align='center' colsep='1' rowsep='1'> <title>Expected character encoding of manual pages</title>
<tgroup cols="2">
<thead> <thead>
<row><entry>Language (code)</entry><entry>Encoding</entry></row> <row>
<entry>Language (code)</entry>
<entry>Encoding</entry>
</row>
</thead> </thead>
<tbody> <tbody>
<row><entry>Danish (da)</entry><entry>ISO-8859-1</entry></row> <row>
<row><entry>German (de)</entry><entry>ISO-8859-1</entry></row> <entry>Danish (da)</entry>
<row><entry>English (en)</entry><entry>ISO-8859-1</entry></row> <entry>ISO-8859-1</entry>
<row><entry>Spanish (es)</entry><entry>ISO-8859-1</entry></row> </row>
<row><entry>Finnish (fi)</entry><entry>ISO-8859-1</entry></row> <row>
<row><entry>French (fr)</entry><entry>ISO-8859-1</entry></row> <entry>German (de)</entry>
<row><entry>Irish (ga)</entry><entry>ISO-8859-1</entry></row> <entry>ISO-8859-1</entry>
<row><entry>Galician (gl)</entry><entry>ISO-8859-1</entry></row> </row>
<row><entry>Indonesian (id)</entry><entry>ISO-8859-1</entry></row> <row>
<row><entry>Icelandic (is)</entry><entry>ISO-8859-1</entry></row> <entry>English (en)</entry>
<row><entry>Italian (it)</entry><entry>ISO-8859-1</entry></row> <entry>ISO-8859-1</entry>
<row><entry>Dutch (nl)</entry><entry>ISO-8859-1</entry></row> </row>
<row>
<entry>Spanish (es)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Finnish (fi)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>French (fr)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Irish (ga)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Galician (gl)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Indonesian (id)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Icelandic (is)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Italian (it)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Dutch (nl)</entry>
<entry>ISO-8859-1</entry>
</row>
<!-- BUG: "no" is deprecated, should use "nb" or "nn" and symlinks --> <!-- BUG: "no" is deprecated, should use "nb" or "nn" and symlinks -->
<row><entry>Norwegian (no)</entry><entry>ISO-8859-1</entry></row> <row>
<entry>Norwegian (no)</entry>
<entry>ISO-8859-1</entry>
</row>
<!-- END BUG --> <!-- END BUG -->
<row><entry>Portuguese (pt)</entry><entry>ISO-8859-1</entry></row> <row>
<row><entry>Swedish (sv)</entry><entry>ISO-8859-1</entry></row> <entry>Portuguese (pt)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>Swedish (sv)</entry>
<entry>ISO-8859-1</entry>
</row>
<!-- Languages below require patched groff --> <!-- Languages below require patched groff -->
<row><entry>Czech (cs)</entry><entry>ISO-8859-2</entry></row> <row>
<row><entry>Croatian (hr)</entry><entry>ISO-8859-2</entry></row> <entry>Czech (cs)</entry>
<row><entry>Hungarian (hu)</entry><entry>ISO-8859-2</entry></row> <entry>ISO-8859-2</entry>
<row><entry>Japanese (ja)</entry><entry>EUC-JP</entry></row> </row>
<row><entry>Korean (ko)</entry><entry>EUC-KR</entry></row> <row>
<row><entry>Polish (pl)</entry><entry>ISO-8859-2</entry></row> <entry>Croatian (hr)</entry>
<row><entry>Russian (ru)</entry><entry>KOI8-R</entry></row> <entry>ISO-8859-2</entry>
<row><entry>Slovak (sk)</entry><entry>ISO-8859-2</entry></row> </row>
<row><entry>Turkish (tr)</entry><entry>ISO-8859-9</entry></row> <row>
<entry>Hungarian (hu)</entry>
<entry>ISO-8859-2</entry>
</row>
<row>
<entry>Japanese (ja)</entry>
<entry>EUC-JP</entry>
</row>
<row>
<entry>Korean (ko)</entry>
<entry>EUC-KR</entry>
</row>
<row>
<entry>Polish (pl)</entry>
<entry>ISO-8859-2</entry>
</row>
<row>
<entry>Russian (ru)</entry>
<entry>KOI8-R</entry>
</row>
<row>
<entry>Slovak (sk)</entry>
<entry>ISO-8859-2</entry>
</row>
<row>
<entry>Turkish (tr)</entry>
<entry>ISO-8859-9</entry>
</row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
<note><para>Manual pages in languages not in the list are not supported. <note>
Norwegian doesn't work now because of the transition from no_NO to nb_NO <para>Manual pages in languages not in the list are not supported.
locale, and Korean is non-functional because of the incomplete Groff patch. Norwegian doesn't work now because of the transition from no_NO to
</para></note> nb_NO locale, and Korean is non-functional because of the incomplete
Groff patch.</para>
</note>
<para>If upstream distributes the manual pages in the same encoding as <para>If upstream distributes the manual pages in the same encoding
Man-DB expects, the manual pages can be copied to as Man-DB expects, the manual pages can be copied to
<filename class="directory">/usr/share/man/<replaceable>[language code]</replaceable></filename>. <filename class="directory">/usr/share/man/<replaceable>[language
E.g., French manual pages code]</replaceable></filename>. E.g., French manual pages
(<ulink url="http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2"/>) (<ulink url="http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2"/>) can be
can be installed with the following command:</para> installed with the following command:</para>
<screen role="nodump"><userinput>mkdir -p /usr/share/man/fr &amp;&amp; <screen role="nodump"><userinput>mkdir -p /usr/share/man/fr &amp;&amp;
cp -rv man? /usr/share/man/fr</userinput></screen> cp -rv man? /usr/share/man/fr</userinput></screen>
<para>If upstream distributes manual pages in UTF-8 (i.e., <quote>for RedHat</quote>) <para>If upstream distributes manual pages in UTF-8 (i.e., <quote>for
instead of the encoding listed in the table above, they have to be RedHat</quote>) instead of the encoding listed in the table above, they
converted from UTF-8 to the encoding listed in the table before have to be converted from UTF-8 to the encoding listed in the table before
installation. E.g., Spanish manual pages installation. E.g., Spanish manual pages (<ulink
(<ulink url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>) url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>)
can be installed with the following commands:</para> can be installed with the following commands:</para>
<screen role="nodump"><userinput>mkdir -p /usr/share/man/es &amp;&amp; <screen role="nodump"><userinput>mkdir -p /usr/share/man/es &amp;&amp;
@ -180,39 +285,52 @@ while read F ; do
done &amp;&amp; done &amp;&amp;
cp -rv man? /usr/share/man/es</userinput></screen> cp -rv man? /usr/share/man/es</userinput></screen>
<note><para>The need to exclude the <filename>man7/iso_8859-7.7</filename> file <note>
from the conversion process because it is already in ISO-8859-1 is a packaging <para>The need to exclude the <filename>man7/iso_8859-7.7</filename> file
bug in man-pages-es-1.55. Future versions should not require this workaround.</para></note> from the conversion process because it is already in ISO-8859-1 is a
packaging bug in man-pages-es-1.55. Future versions should not require
this workaround.</para>
</note>
</sect2> </sect2>
<sect2 id="contents-man-db" role="content"><title>Contents of Man-DB</title> <sect2 id="contents-man-db" role="content">
<title>Contents of Man-DB</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>accessdb, apropos, catman, lexgrog, man, mandb, manpath,
and whatis</seg></seglistitem> <seglistitem>
<seg>accessdb, apropos, catman, lexgrog, man, mandb, manpath,
and whatis</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="accessdb"> <varlistentry id="accessdb">
<term><command>accessdb</command></term> <term><command>accessdb</command></term>
<listitem> <listitem>
<para>Dumps the <command>whatis</command> database contents in human-readable form</para> <para>Dumps the <command>whatis</command> database contents in
<indexterm zone="ch-system-man-db accessdb"><primary sortas="b-accessdb">accessdb</primary></indexterm> human-readable form</para>
<indexterm zone="ch-system-man-db accessdb">
<primary sortas="b-accessdb">accessdb</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="apropos"> <varlistentry id="apropos">
<term><command>apropos</command></term> <term><command>apropos</command></term>
<listitem> <listitem>
<para>Searches the <command>whatis</command> database and displays the short descriptions <para>Searches the <command>whatis</command> database and displays
of system commands that contain a given string</para> the short descriptions of system commands that contain a given
<indexterm zone="ch-system-man-db apropos"><primary sortas="b-apropos">apropos</primary></indexterm> string</para>
<indexterm zone="ch-system-man-db apropos">
<primary sortas="b-apropos">apropos</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -220,15 +338,20 @@ of system commands that contain a given string</para>
<term><command>catman</command></term> <term><command>catman</command></term>
<listitem> <listitem>
<para>Creates or updates the pre-formatted manual pages</para> <para>Creates or updates the pre-formatted manual pages</para>
<indexterm zone="ch-system-man-db catman"><primary sortas="b-catman">catman</primary></indexterm> <indexterm zone="ch-system-man-db catman">
<primary sortas="b-catman">catman</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="lexgrog"> <varlistentry id="lexgrog">
<term><command>lexgrog</command></term> <term><command>lexgrog</command></term>
<listitem> <listitem>
<para>Displays one-line summary information about a given manual page</para> <para>Displays one-line summary information about a given manual
<indexterm zone="ch-system-man-db lexgrog"><primary sortas="b-lexgrog">lexgrog</primary></indexterm> page</para>
<indexterm zone="ch-system-man-db lexgrog">
<primary sortas="b-lexgrog">lexgrog</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -236,7 +359,9 @@ of system commands that contain a given string</para>
<term><command>man</command></term> <term><command>man</command></term>
<listitem> <listitem>
<para>Formats and displays the requested manual page</para> <para>Formats and displays the requested manual page</para>
<indexterm zone="ch-system-man-db man"><primary sortas="b-man">man</primary></indexterm> <indexterm zone="ch-system-man-db man">
<primary sortas="b-man">man</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -244,22 +369,26 @@ of system commands that contain a given string</para>
<term><command>mandb</command></term> <term><command>mandb</command></term>
<listitem> <listitem>
<para>Creates or updates the <command>whatis</command> database</para> <para>Creates or updates the <command>whatis</command> database</para>
<indexterm zone="ch-system-man-db mandb"><primary sortas="b-mandb">mandb</primary></indexterm> <indexterm zone="ch-system-man-db mandb">
<primary sortas="b-mandb">mandb</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="whatis"> <varlistentry id="whatis">
<term><command>whatis</command></term> <term><command>whatis</command></term>
<listitem> <listitem>
<para>Searches the <command>whatis</command> database and displays the short descriptions <para>Searches the <command>whatis</command> database and displays
of system commands that contain the given keyword as a separate the short descriptions of system commands that contain the given
word</para> keyword as a separate word</para>
<indexterm zone="ch-system-man-db whatis"><primary sortas="b-whatis">whatis</primary></indexterm> <indexterm zone="ch-system-man-db whatis">
<primary sortas="b-whatis">whatis</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

45
chapter06/man-pages.xml
View File

@ -1,27 +1,42 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-man-pages" role="wrap"> <sect1 id="ch-system-man-pages" role="wrap">
<title>Man-pages-&man-pages-version;</title>
<?dbhtml filename="man-pages.html"?> <?dbhtml filename="man-pages.html"?>
<indexterm zone="ch-system-man-pages"><primary sortas="a-Man-pages">Man-pages</primary></indexterm> <title>Man-pages-&man-pages-version;</title>
<indexterm zone="ch-system-man-pages">
<primary sortas="a-Man-pages">Man-pages</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Man-pages package contains over 1,200 man pages.</para> <para>The Man-pages package contains over 1,200 man pages.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>18.6 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>18.6 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Coreutils, and Make</seg></seglistitem>
<seglistitem>
<seg>Bash, Coreutils, and Make</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -33,15 +48,19 @@
</sect2> </sect2>
<sect2 id="contents-manpages" role="content">
<sect2 id="contents-manpages" role="content"><title>Contents of Man-pages</title> <title>Contents of Man-pages</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed files</segtitle> <segtitle>Installed files</segtitle>
<seglistitem><seg>various man pages</seg></seglistitem>
<seglistitem>
<seg>various man pages</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -50,12 +69,14 @@
<listitem> <listitem>
<para>Describe the C and C++ functions, important <para>Describe the C and C++ functions, important
device files, and significant configuration files</para> device files, and significant configuration files</para>
<indexterm zone="ch-system-man-pages man-pages"><primary sortas="e-man-pages">man pages</primary></indexterm> <indexterm zone="ch-system-man-pages man-pages">
<primary sortas="e-man-pages">man pages</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

70
chapter06/mktemp.xml
View File

@ -1,28 +1,43 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-mktemp" role="wrap"> <sect1 id="ch-system-mktemp" role="wrap">
<title>Mktemp-&mktemp-version;</title>
<?dbhtml filename="mktemp.html"?> <?dbhtml filename="mktemp.html"?>
<indexterm zone="ch-system-mktemp"><primary sortas="a-Mktemp">Mktemp</primary></indexterm> <title>Mktemp-&mktemp-version;</title>
<indexterm zone="ch-system-mktemp">
<primary sortas="a-Mktemp">Mktemp</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Mktemp package contains programs used to create secure temporary <para>The Mktemp package contains programs used to create secure temporary
files in shell scripts.</para> files in shell scripts.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>436 KB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>436 KB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Coreutils, Make, and Patch</seg></seglistitem>
<seglistitem>
<seg>Coreutils, Make, and Patch</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -39,16 +54,19 @@ to <command>mktemp</command>. Patch Mktemp to include a
<screen><userinput>./configure --prefix=/usr --with-libc</userinput></screen> <screen><userinput>./configure --prefix=/usr --with-libc</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--with-libc</parameter></term> <term><parameter>--with-libc</parameter></term>
<listitem><para>This causes the <command>mktemp</command> program to <listitem>
use the <emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis> <para>This causes the <command>mktemp</command> program to use the
functions from the system C library instead of its own implementation of them. <emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis>
</para></listitem> functions from the system C library instead of its own implementation
of them. </para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -64,23 +82,30 @@ make install-tempfile</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-mktemp" role="content">
<sect2 id="contents-mktemp" role="content"><title>Contents of Mktemp</title> <title>Contents of Mktemp</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>mktemp and tempfile</seg></seglistitem>
<seglistitem>
<seg>mktemp and tempfile</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="mktemp"> <varlistentry id="mktemp">
<term><command>mktemp</command></term> <term><command>mktemp</command></term>
<listitem> <listitem>
<para>Creates temporary files in a secure manner; it is used in scripts</para> <para>Creates temporary files in a secure manner; it is used in
<indexterm zone="ch-system-mktemp mktemp"><primary sortas="b-mktemp">mktemp</primary></indexterm> scripts</para>
<indexterm zone="ch-system-mktemp mktemp">
<primary sortas="b-mktemp">mktemp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -88,13 +113,16 @@ make install-tempfile</userinput></screen>
<term><command>tempfile</command></term> <term><command>tempfile</command></term>
<listitem> <listitem>
<para>Creates temporary files in a less secure manner than <para>Creates temporary files in a less secure manner than
<command>mktemp</command>; it is installed for backwards-compatibility</para> <command>mktemp</command>; it is installed for
<indexterm zone="ch-system-mktemp tempfile"><primary sortas="b-tempfile">tempfile</primary></indexterm> backwards-compatibility</para>
<indexterm zone="ch-system-mktemp tempfile">
<primary sortas="b-tempfile">tempfile</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

86
chapter06/module-init-tools.xml
View File

@ -1,29 +1,44 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-module-init-tools" role="wrap"> <sect1 id="ch-system-module-init-tools" role="wrap">
<title>Module-Init-Tools-&module-init-tools-version;</title>
<?dbhtml filename="module-init-tools.html"?> <?dbhtml filename="module-init-tools.html"?>
<indexterm zone="ch-system-module-init-tools"><primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary></indexterm> <title>Module-Init-Tools-&module-init-tools-version;</title>
<indexterm zone="ch-system-module-init-tools">
<primary sortas="a-Module-Init-Tools">Module-Init-Tools</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Module-Init-Tools package contains programs for handling kernel <para>The Module-Init-Tools package contains programs for handling kernel
modules in Linux kernels greater than or equal to version 2.5.47.</para> modules in Linux kernels greater than or equal to version 2.5.47.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.3 SBU</seg><seg>3.3 MB</seg></seglistitem>
<seglistitem>
<seg>0.3 SBU</seg>
<seg>3.3 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Bison,
Coreutils, Diffutils, Flex, GCC, Glibc, Grep, M4, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, Flex, GCC, Glibc,
Grep, M4, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -51,16 +66,20 @@ make distclean</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-module-init-tools" role="content">
<sect2 id="contents-module-init-tools" role="content"><title>Contents of Module-Init-Tools</title> <title>Contents of Module-Init-Tools</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>depmod, generate-modprobe.conf, insmod,
insmod.static, lsmod, modinfo, modprobe, and rmmod</seg></seglistitem> <seglistitem>
<seg>depmod, generate-modprobe.conf, insmod, insmod.static, lsmod,
modinfo, modprobe, and rmmod</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -68,17 +87,23 @@ insmod.static, lsmod, modinfo, modprobe, and rmmod</seg></seglistitem>
<term><command>depmod</command></term> <term><command>depmod</command></term>
<listitem> <listitem>
<para>Creates a dependency file based on the symbols it finds in the <para>Creates a dependency file based on the symbols it finds in the
existing set of modules; this dependency file is used by <command>modprobe</command> to existing set of modules; this dependency file is used by
automatically load the required modules</para> <command>modprobe</command> to automatically load the required
<indexterm zone="ch-system-module-init-tools depmod"><primary sortas="b-depmod">depmod</primary></indexterm> modules</para>
<indexterm zone="ch-system-module-init-tools depmod">
<primary sortas="b-depmod">depmod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="generate-modprobe.conf"> <varlistentry id="generate-modprobe.conf">
<term><command>generate-modprobe.conf</command></term> <term><command>generate-modprobe.conf</command></term>
<listitem> <listitem>
<para>Creates a modprobe.conf file from an existing 2.2 or 2.4 module setup</para> <para>Creates a modprobe.conf file from an existing 2.2 or 2.4 module
<indexterm zone="ch-system-module-init-tools generate-modprobe.conf"><primary sortas="b-generate-modprobe.conf">generate-modprobe.conf</primary></indexterm> setup</para>
<indexterm zone="ch-system-module-init-tools generate-modprobe.conf">
<primary sortas="b-generate-modprobe.conf">generate-modprobe.conf</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -86,7 +111,9 @@ automatically load the required modules</para>
<term><command>insmod</command></term> <term><command>insmod</command></term>
<listitem> <listitem>
<para>Installs a loadable module in the running kernel</para> <para>Installs a loadable module in the running kernel</para>
<indexterm zone="ch-system-module-init-tools insmod"><primary sortas="b-insmod">insmod</primary></indexterm> <indexterm zone="ch-system-module-init-tools insmod">
<primary sortas="b-insmod">insmod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -94,8 +121,9 @@ automatically load the required modules</para>
<term><command>insmod.static</command></term> <term><command>insmod.static</command></term>
<listitem> <listitem>
<para>A statically compiled version of <command>insmod</command></para> <para>A statically compiled version of <command>insmod</command></para>
<indexterm zone="ch-system-module-init-tools insmod.static"><primary <indexterm zone="ch-system-module-init-tools insmod.static">
sortas="b-insmod.static">insmod.static</primary></indexterm> <primary sortas="b-insmod.static">insmod.static</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -103,7 +131,9 @@ sortas="b-insmod.static">insmod.static</primary></indexterm>
<term><command>lsmod</command></term> <term><command>lsmod</command></term>
<listitem> <listitem>
<para>Lists currently loaded modules</para> <para>Lists currently loaded modules</para>
<indexterm zone="ch-system-module-init-tools lsmod"><primary sortas="b-lsmod">lsmod</primary></indexterm> <indexterm zone="ch-system-module-init-tools lsmod">
<primary sortas="b-lsmod">lsmod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -112,7 +142,9 @@ sortas="b-insmod.static">insmod.static</primary></indexterm>
<listitem> <listitem>
<para>Examines an object file associated with a kernel module and <para>Examines an object file associated with a kernel module and
displays any information that it can glean</para> displays any information that it can glean</para>
<indexterm zone="ch-system-module-init-tools modinfo"><primary sortas="b-modinfo">modinfo</primary></indexterm> <indexterm zone="ch-system-module-init-tools modinfo">
<primary sortas="b-modinfo">modinfo</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -121,7 +153,9 @@ displays any information that it can glean</para>
<listitem> <listitem>
<para>Uses a dependency file, created by <para>Uses a dependency file, created by
<command>depmod</command>, to automatically load relevant modules</para> <command>depmod</command>, to automatically load relevant modules</para>
<indexterm zone="ch-system-module-init-tools modprobe"><primary sortas="b-modprobe">modprobe</primary></indexterm> <indexterm zone="ch-system-module-init-tools modprobe">
<primary sortas="b-modprobe">modprobe</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -129,12 +163,14 @@ displays any information that it can glean</para>
<term><command>rmmod</command></term> <term><command>rmmod</command></term>
<listitem> <listitem>
<para>Unloads modules from the running kernel</para> <para>Unloads modules from the running kernel</para>
<indexterm zone="ch-system-module-init-tools rmmod"><primary sortas="b-rmmod">rmmod</primary></indexterm> <indexterm zone="ch-system-module-init-tools rmmod">
<primary sortas="b-rmmod">rmmod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

150
chapter06/ncurses.xml
View File

@ -1,29 +1,44 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-ncurses" role="wrap"> <sect1 id="ch-system-ncurses" role="wrap">
<title>Ncurses-&ncurses-version;</title>
<?dbhtml filename="ncurses.html"?> <?dbhtml filename="ncurses.html"?>
<indexterm zone="ch-system-ncurses"><primary sortas="a-Ncurses">Ncurses</primary></indexterm> <title>Ncurses-&ncurses-version;</title>
<indexterm zone="ch-system-ncurses">
<primary sortas="a-Ncurses">Ncurses</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Ncurses package contains libraries for terminal-independent <para>The Ncurses package contains libraries for terminal-independent
handling of character screens.</para> handling of character screens.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.6 SBU</seg><seg>18.6 MB</seg></seglistitem>
<seglistitem>
<seg>0.6 SBU</seg>
<seg>18.6 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, Gawk, GCC, Glibc, Grep,
Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -46,30 +61,34 @@ display bugs were found and fixed upstream. Apply those fixes:</para>
<screen><userinput>./configure --prefix=/usr --with-shared --without-debug --enable-widec</userinput></screen> <screen><userinput>./configure --prefix=/usr --with-shared --without-debug --enable-widec</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure option:</title>
<varlistentry> <varlistentry>
<term><parameter>--enable-widec</parameter></term> <term><parameter>--enable-widec</parameter></term>
<listitem><para>This switch causes wide-character libraries <listitem>
(e.g., <filename class="libraryfile">libncursesw.so.&ncurses-version;</filename>) <para>This switch causes wide-character libraries (e.g., <filename
to be built instead of normal ones class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
(e.g., <filename class="libraryfile">libncurses.so.&ncurses-version;</filename>). to be built instead of normal ones (e.g., <filename
These wide-character libraries are usable in both multibyte and traditional 8-bit class="libraryfile">libncurses.so.&ncurses-version;</filename>).
locales, while normal libraries work properly only in 8-bit locales. These wide-character libraries are usable in both multibyte and
Wide-character and normal libraries are source-compatible, but not traditional 8-bit locales, while normal libraries work properly
binary-compatible.</para> only in 8-bit locales. Wide-character and normal libraries are
source-compatible, but not binary-compatible.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<!-- <!--
<varlistentry> <varlistentry>
<term><parameter>- -without-cxx-binding</parameter></term> <term><parameter>- -without-cxx-binding</parameter></term>
<listitem><para>This optional switch causes the <listitem>
<para>This optional switch causes the
<filename class="libraryfile">libncurses++w.a</filename> library <filename class="libraryfile">libncurses++w.a</filename> library
not to be built. Nothing in LFS and BLFS uses this library.</para> not to be built. Nothing in LFS and BLFS uses this library.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
--> -->
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -120,34 +139,41 @@ ln -sfv libncurses.so /usr/lib/libcurses.so &amp;&amp;
ln -sfv libncursesw.a /usr/lib/libcursesw.a &amp;&amp; ln -sfv libncursesw.a /usr/lib/libcursesw.a &amp;&amp;
ln -sfv libncurses.a /usr/lib/libcurses.a</userinput></screen> ln -sfv libncurses.a /usr/lib/libcurses.a</userinput></screen>
<note><para>The instructions above don't create non-wide-character Ncurses <note>
libraries since no package installed by compiling from sources would link <para>The instructions above don't create non-wide-character Ncurses
against them at runtime. libraries since no package installed by compiling from sources would
If you must have such libraries because of some binary-only application, link against them at runtime. If you must have such libraries because
build them with the following commands:</para> of some binary-only application, build them with the following
commands:</para>
<screen role="nodump"><userinput>make distclean &amp;&amp; <screen role="nodump"><userinput>make distclean &amp;&amp;
./configure --prefix=/usr --with-shared --without-normal \ ./configure --prefix=/usr --with-shared --without-normal \
--without-debug --without-cxx-binding &amp;&amp; --without-debug --without-cxx-binding &amp;&amp;
make sources libs &amp;&amp; make sources libs &amp;&amp;
cp -av lib/lib*.so.5* /usr/lib</userinput></screen> cp -av lib/lib*.so.5* /usr/lib</userinput></screen>
</note> </note>
</sect2> </sect2>
<sect2 id="contents-ncurses" role="content">
<sect2 id="contents-ncurses" role="content"><title>Contents of Ncurses</title> <title>Contents of Ncurses</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>captoinfo (link to tic), clear, infocmp, infotocap (link to tic),
<seglistitem>
<seg>captoinfo (link to tic), clear, infocmp, infotocap (link to tic),
reset (link to tset), tack, tic, toe, tput, and tset</seg> reset (link to tset), tack, tic, toe, tput, and tset</seg>
<seg>libcursesw.[a,so] (symlink and linker script to libncursesw.[a,so]), <seg>libcursesw.[a,so] (symlink and linker script to libncursesw.[a,so]),
libformw.[a,so], libmenuw.[a,so], libformw.[a,so], libmenuw.[a,so], libncurses++w.a, libncursesw.[a,so],
libncurses++w.a, libncursesw.[a,so], libpanelw.[a,so] and their libpanelw.[a,so] and their non-wide-character counterparts without "w"
non-wide-character counterparts without "w" in the library names.</seg></seglistitem> in the library names.</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -155,7 +181,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>captoinfo</command></term> <term><command>captoinfo</command></term>
<listitem> <listitem>
<para>Converts a termcap description into a terminfo description</para> <para>Converts a termcap description into a terminfo description</para>
<indexterm zone="ch-system-ncurses captoinfo"><primary sortas="b-captoinfo">captoinfo</primary></indexterm> <indexterm zone="ch-system-ncurses captoinfo">
<primary sortas="b-captoinfo">captoinfo</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -163,7 +191,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>clear</command></term> <term><command>clear</command></term>
<listitem> <listitem>
<para>Clears the screen, if possible</para> <para>Clears the screen, if possible</para>
<indexterm zone="ch-system-ncurses clear"><primary sortas="b-clear">clear</primary></indexterm> <indexterm zone="ch-system-ncurses clear">
<primary sortas="b-clear">clear</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -171,7 +201,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>infocmp</command></term> <term><command>infocmp</command></term>
<listitem> <listitem>
<para>Compares or prints out terminfo descriptions</para> <para>Compares or prints out terminfo descriptions</para>
<indexterm zone="ch-system-ncurses infocmp"><primary sortas="b-infocmp">infocmp</primary></indexterm> <indexterm zone="ch-system-ncurses infocmp">
<primary sortas="b-infocmp">infocmp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -179,7 +211,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>infotocap</command></term> <term><command>infotocap</command></term>
<listitem> <listitem>
<para>Converts a terminfo description into a termcap description</para> <para>Converts a terminfo description into a termcap description</para>
<indexterm zone="ch-system-ncurses infotocap"><primary sortas="b-infotocap">infotocap</primary></indexterm> <indexterm zone="ch-system-ncurses infotocap">
<primary sortas="b-infotocap">infotocap</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -187,7 +221,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>reset</command></term> <term><command>reset</command></term>
<listitem> <listitem>
<para>Reinitializes a terminal to its default values</para> <para>Reinitializes a terminal to its default values</para>
<indexterm zone="ch-system-ncurses reset"><primary sortas="b-reset">reset</primary></indexterm> <indexterm zone="ch-system-ncurses reset">
<primary sortas="b-reset">reset</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -196,7 +232,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<listitem> <listitem>
<para>The terminfo action checker; it is mainly used to test the <para>The terminfo action checker; it is mainly used to test the
accuracy of an entry in the terminfo database</para> accuracy of an entry in the terminfo database</para>
<indexterm zone="ch-system-ncurses tack"><primary sortas="b-tack">tack</primary></indexterm> <indexterm zone="ch-system-ncurses tack">
<primary sortas="b-tack">tack</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -207,7 +245,9 @@ accuracy of an entry in the terminfo database</para>
terminfo file from source format into the binary format needed for the terminfo file from source format into the binary format needed for the
ncurses library routines. A terminfo file contains information on the ncurses library routines. A terminfo file contains information on the
capabilities of a certain terminal</para> capabilities of a certain terminal</para>
<indexterm zone="ch-system-ncurses tic"><primary sortas="b-tic">tic</primary></indexterm> <indexterm zone="ch-system-ncurses tic">
<primary sortas="b-tic">tic</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -216,7 +256,9 @@ capabilities of a certain terminal</para>
<listitem> <listitem>
<para>Lists all available terminal types, giving the primary name and <para>Lists all available terminal types, giving the primary name and
description for each</para> description for each</para>
<indexterm zone="ch-system-ncurses toe"><primary sortas="b-toe">toe</primary></indexterm> <indexterm zone="ch-system-ncurses toe">
<primary sortas="b-toe">toe</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -226,7 +268,9 @@ description for each</para>
<para>Makes the values of terminal-dependent capabilities available to <para>Makes the values of terminal-dependent capabilities available to
the shell; it can also be used to reset or initialize a terminal or the shell; it can also be used to reset or initialize a terminal or
report its long name</para> report its long name</para>
<indexterm zone="ch-system-ncurses tput"><primary sortas="b-tput">tput</primary></indexterm> <indexterm zone="ch-system-ncurses tput">
<primary sortas="b-tput">tput</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -234,7 +278,9 @@ report its long name</para>
<term><command>tset</command></term> <term><command>tset</command></term>
<listitem> <listitem>
<para>Can be used to initialize terminals</para> <para>Can be used to initialize terminals</para>
<indexterm zone="ch-system-ncurses tset"><primary sortas="b-tset">tset</primary></indexterm> <indexterm zone="ch-system-ncurses tset">
<primary sortas="b-tset">tset</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -242,7 +288,9 @@ report its long name</para>
<term><filename class="libraryfile">libcurses</filename></term> <term><filename class="libraryfile">libcurses</filename></term>
<listitem> <listitem>
<para>A link to <filename>libncurses</filename></para> <para>A link to <filename>libncurses</filename></para>
<indexterm zone="ch-system-ncurses libcurses"><primary sortas="c-libcurses">libcurses</primary></indexterm> <indexterm zone="ch-system-ncurses libcurses">
<primary sortas="c-libcurses">libcurses</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -251,8 +299,11 @@ report its long name</para>
<listitem> <listitem>
<para>Contains functions to display text in many complex ways on a <para>Contains functions to display text in many complex ways on a
terminal screen; a good example of the use of these functions is the terminal screen; a good example of the use of these functions is the
menu displayed during the kernel's <command>make menuconfig</command></para> menu displayed during the kernel's <command>make
<indexterm zone="ch-system-ncurses libncurses"><primary sortas="c-libncurses">libncurses</primary></indexterm> menuconfig</command></para>
<indexterm zone="ch-system-ncurses libncurses">
<primary sortas="c-libncurses">libncurses</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -260,7 +311,9 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libform</filename></term> <term><filename class="libraryfile">libform</filename></term>
<listitem> <listitem>
<para>Contains functions to implement forms</para> <para>Contains functions to implement forms</para>
<indexterm zone="ch-system-ncurses libform"><primary sortas="c-libform">libform</primary></indexterm> <indexterm zone="ch-system-ncurses libform">
<primary sortas="c-libform">libform</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -268,7 +321,9 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libmenu</filename></term> <term><filename class="libraryfile">libmenu</filename></term>
<listitem> <listitem>
<para>Contains functions to implement menus</para> <para>Contains functions to implement menus</para>
<indexterm zone="ch-system-ncurses libmenu"><primary sortas="c-libmenu">libmenu</primary></indexterm> <indexterm zone="ch-system-ncurses libmenu">
<primary sortas="c-libmenu">libmenu</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -276,9 +331,12 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libpanel</filename></term> <term><filename class="libraryfile">libpanel</filename></term>
<listitem> <listitem>
<para>Contains functions to implement panels</para> <para>Contains functions to implement panels</para>
<indexterm zone="ch-system-ncurses libpanel"><primary sortas="c-libpanel">libpanel</primary></indexterm> <indexterm zone="ch-system-ncurses libpanel">
<primary sortas="c-libpanel">libpanel</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>

59
chapter06/patch.xml
View File

@ -1,30 +1,45 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-patch" role="wrap"> <sect1 id="ch-system-patch" role="wrap">
<title>Patch-&patch-version;</title>
<?dbhtml filename="patch.html"?> <?dbhtml filename="patch.html"?>
<indexterm zone="ch-system-patch"><primary sortas="a-Patch">Patch</primary></indexterm> <title>Patch-&patch-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-patch">
<para>The Patch package contains a program for modifying or creating files by <primary sortas="a-Patch">Patch</primary>
applying a <quote>patch</quote> file typically created by the </indexterm>
<sect2 role="package">
<title/>
<para>The Patch package contains a program for modifying or creating files
by applying a <quote>patch</quote> file typically created by the
<command>diff</command> program.</para> <command>diff</command> program.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>1.5 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>1.5 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -46,31 +61,37 @@ GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
</sect2> </sect2>
<sect2 id="contents-patch" role="content">
<sect2 id="contents-patch" role="content"><title>Contents of Patch</title> <title>Contents of Patch</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed program</segtitle> <segtitle>Installed program</segtitle>
<seglistitem><seg>patch</seg></seglistitem>
<seglistitem>
<seg>patch</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="patch"> <varlistentry id="patch">
<term><command>patch</command></term> <term><command>patch</command></term>
<listitem> <listitem>
<para>Modifies files according to a patch file. A patch file is normally <para>Modifies files according to a patch file. A patch file is
a difference listing created with the <command>diff</command> program. By applying normally a difference listing created with the <command>diff</command>
these differences to the original files, <command>patch</command> creates the patched program. By applying these differences to the original files,
versions.</para> <command>patch</command> creates the patched versions.</para>
<indexterm zone="ch-system-patch patch"><primary sortas="b-patch">patch</primary></indexterm> <indexterm zone="ch-system-patch patch">
<primary sortas="b-patch">patch</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>