gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-19 03:39: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"?>
<!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">
%general-entities;
]>
<sect1 id="ch-system-man-db" role="wrap">
<title>Man-DB-&man-db-version;</title>
<?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/>
<para>The Man-DB package contains programs for finding and viewing man pages.</para>
<indexterm zone="ch-system-man-db">
<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>
<segtitle>&buildtime;</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>
<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>
</sect2>
<sect2 role="installation">
@ -40,10 +56,10 @@ mv man/it{_IT.88591,} &amp;&amp;
mv man/ja{_JP.eucJP,} &amp;&amp;
sed -i 's,\*_\*,??,' man/Makefile.in</userinput></screen>
<para>The second change is a <command>sed</command> substitution to delete the
<quote>/usr/man</quote> lines in the
<filename>man_db.conf</filename> file to prevent redundant results when
using programs such as <command>whatis</command>:</para>
<para>The second change is a <command>sed</command> substitution to delete
the <quote>/usr/man</quote> lines in the <filename>man_db.conf</filename>
file to prevent redundant results when using programs such as
<command>whatis</command>:</para>
<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>
EOF</userinput></screen>
<para>The <command>col</command> program is a part of the Util-linux package,
<command>lynx</command> is a text-based web browser
(see BLFS for installation instructions),
<command>vgrind</command> converts program sources to Groff input,
and <command>grap</command> is useful for typesetting graphs in Groff documents.
The <command>vgrind</command> and <command>grap</command> programs are
not normally needed for viewing manual pages. They are
not part of LFS or BLFS, but you should be able to install them yourself
after finishing LFS if you wish to do so.</para>
<para>The <command>col</command> program is a part of the Util-linux
package, <command>lynx</command> is a text-based web browser (see BLFS
for installation instructions), <command>vgrind</command> converts
program sources to Groff input, and <command>grap</command> is useful
for typesetting graphs in Groff documents. The <command>vgrind</command>
and <command>grap</command> programs are not normally needed for viewing
manual pages. They are not part of LFS or BLFS, but you should be able
to install them yourself after finishing LFS if you wish to do so.</para>
<para>Prepare Man-DB for compilation:</para>
<screen><userinput>./configure --prefix=/usr --enable-mb-groff --disable-setuid</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure options:</title>
<varlistentry>
<term><parameter>--enable-mb-groff</parameter></term>
<listitem><para>This tells the <command>man</command> program to
use the <quote>ascii8</quote> and <quote>nippon</quote> Groff devices for formatting non-ISO-8859-1
manual pages.</para></listitem>
<listitem>
<para>This tells the <command>man</command> program to use the
<quote>ascii8</quote> and <quote>nippon</quote> Groff devices for
formatting non-ISO-8859-1 manual pages.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>--disable-setuid</parameter></term>
<listitem><para>This disables making the <command>man</command> program
setuid to user <quote>man</quote>.</para></listitem>
<listitem>
<para>This disables making the <command>man</command> program setuid
to user <systemitem class="username">man</systemitem>.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Compile the package:</para>
@ -101,7 +122,8 @@ man and info pages can be found in the BLFS book at
</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
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>
<!-- Origin: man-db-2.4.3/src/encodings.c -->
<table frame='all'><title>Expected character encoding of manual pages</title>
<tgroup cols='2' align='center' colsep='1' rowsep='1'>
<table>
<title>Expected character encoding of manual pages</title>
<tgroup cols="2">
<thead>
<row><entry>Language (code)</entry><entry>Encoding</entry></row>
<row>
<entry>Language (code)</entry>
<entry>Encoding</entry>
</row>
</thead>
<tbody>
<row><entry>Danish (da)</entry><entry>ISO-8859-1</entry></row>
<row><entry>German (de)</entry><entry>ISO-8859-1</entry></row>
<row><entry>English (en)</entry><entry>ISO-8859-1</entry></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>
<row>
<entry>Danish (da)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>German (de)</entry>
<entry>ISO-8859-1</entry>
</row>
<row>
<entry>English (en)</entry>
<entry>ISO-8859-1</entry>
</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 -->
<row><entry>Norwegian (no)</entry><entry>ISO-8859-1</entry></row>
<row>
<entry>Norwegian (no)</entry>
<entry>ISO-8859-1</entry>
</row>
<!-- END BUG -->
<row><entry>Portuguese (pt)</entry><entry>ISO-8859-1</entry></row>
<row><entry>Swedish (sv)</entry><entry>ISO-8859-1</entry></row>
<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 -->
<row><entry>Czech (cs)</entry><entry>ISO-8859-2</entry></row>
<row><entry>Croatian (hr)</entry><entry>ISO-8859-2</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>
<row>
<entry>Czech (cs)</entry>
<entry>ISO-8859-2</entry>
</row>
<row>
<entry>Croatian (hr)</entry>
<entry>ISO-8859-2</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>
</tgroup>
</table>
<note><para>Manual pages in languages not in the list are not supported.
Norwegian doesn't work now because of the transition from no_NO to nb_NO
locale, and Korean is non-functional because of the incomplete Groff patch.
</para></note>
<note>
<para>Manual pages in languages not in the list are not supported.
Norwegian doesn't work now because of the transition from no_NO to
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
Man-DB expects, the manual pages can be copied to
<filename class="directory">/usr/share/man/<replaceable>[language code]</replaceable></filename>.
E.g., French manual pages
(<ulink url="http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2"/>)
can be installed with the following command:</para>
<para>If upstream distributes the manual pages in the same encoding
as Man-DB expects, the manual pages can be copied to
<filename class="directory">/usr/share/man/<replaceable>[language
code]</replaceable></filename>. E.g., French manual pages
(<ulink url="http://ccb.club.fr/man/man-fr-1.58.0.tar.bz2"/>) can be
installed with the following command:</para>
<screen role="nodump"><userinput>mkdir -p /usr/share/man/fr &amp;&amp;
cp -rv man? /usr/share/man/fr</userinput></screen>
<para>If upstream distributes manual pages in UTF-8 (i.e., <quote>for RedHat</quote>)
instead of the encoding listed in the table above, they have to be
converted from UTF-8 to the encoding listed in the table before
installation. E.g., Spanish manual pages
(<ulink url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>)
<para>If upstream distributes manual pages in UTF-8 (i.e., <quote>for
RedHat</quote>) instead of the encoding listed in the table above, they
have to be converted from UTF-8 to the encoding listed in the table before
installation. E.g., Spanish manual pages (<ulink
url="http://ditec.um.es/~piernas/manpages-es/man-pages-es-1.55.tar.bz2"/>)
can be installed with the following commands:</para>
<screen role="nodump"><userinput>mkdir -p /usr/share/man/es &amp;&amp;
@ -180,39 +285,52 @@ while read F ; do
done &amp;&amp;
cp -rv man? /usr/share/man/es</userinput></screen>
<note><para>The need to exclude the <filename>man7/iso_8859-7.7</filename> file
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>
<note>
<para>The need to exclude the <filename>man7/iso_8859-7.7</filename> file
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 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>
<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>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="accessdb">
<term><command>accessdb</command></term>
<listitem>
<para>Dumps the <command>whatis</command> database contents in human-readable form</para>
<indexterm zone="ch-system-man-db accessdb"><primary sortas="b-accessdb">accessdb</primary></indexterm>
<para>Dumps the <command>whatis</command> database contents in
human-readable form</para>
<indexterm zone="ch-system-man-db accessdb">
<primary sortas="b-accessdb">accessdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="apropos">
<term><command>apropos</command></term>
<listitem>
<para>Searches the <command>whatis</command> database and displays the short descriptions
of system commands that contain a given string</para>
<indexterm zone="ch-system-man-db apropos"><primary sortas="b-apropos">apropos</primary></indexterm>
<para>Searches the <command>whatis</command> database and displays
the short descriptions of system commands that contain a given
string</para>
<indexterm zone="ch-system-man-db apropos">
<primary sortas="b-apropos">apropos</primary>
</indexterm>
</listitem>
</varlistentry>
@ -220,15 +338,20 @@ of system commands that contain a given string</para>
<term><command>catman</command></term>
<listitem>
<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>
</varlistentry>
<varlistentry id="lexgrog">
<term><command>lexgrog</command></term>
<listitem>
<para>Displays one-line summary information about a given manual page</para>
<indexterm zone="ch-system-man-db lexgrog"><primary sortas="b-lexgrog">lexgrog</primary></indexterm>
<para>Displays one-line summary information about a given manual
page</para>
<indexterm zone="ch-system-man-db lexgrog">
<primary sortas="b-lexgrog">lexgrog</primary>
</indexterm>
</listitem>
</varlistentry>
@ -236,7 +359,9 @@ of system commands that contain a given string</para>
<term><command>man</command></term>
<listitem>
<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>
</varlistentry>
@ -244,22 +369,26 @@ of system commands that contain a given string</para>
<term><command>mandb</command></term>
<listitem>
<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>
</varlistentry>
<varlistentry id="whatis">
<term><command>whatis</command></term>
<listitem>
<para>Searches the <command>whatis</command> database and displays the short descriptions
of system commands that contain the given keyword as a separate
word</para>
<indexterm zone="ch-system-man-db whatis"><primary sortas="b-whatis">whatis</primary></indexterm>
<para>Searches the <command>whatis</command> database and displays
the short descriptions of system commands that contain the given
keyword as a separate word</para>
<indexterm zone="ch-system-man-db whatis">
<primary sortas="b-whatis">whatis</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

45
chapter06/man-pages.xml
View File

@ -1,27 +1,42 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-man-pages" role="wrap">
<title>Man-pages-&man-pages-version;</title>
<?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>
<segmentedlist>
<segtitle>&buildtime;</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>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Coreutils, and Make</seg></seglistitem>
<seglistitem>
<seg>Bash, Coreutils, and Make</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
@ -33,15 +48,19 @@
</sect2>
<sect2 id="contents-manpages" role="content"><title>Contents of Man-pages</title>
<sect2 id="contents-manpages" role="content">
<title>Contents of Man-pages</title>
<segmentedlist>
<segtitle>Installed files</segtitle>
<seglistitem><seg>various man pages</seg></seglistitem>
<seglistitem>
<seg>various man pages</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -50,12 +69,14 @@
<listitem>
<para>Describe the C and C++ functions, important
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>
</varlistentry>
</variablelist>
</sect2>
</sect1>

70
chapter06/mktemp.xml
View File

@ -1,28 +1,43 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-mktemp" role="wrap">
<title>Mktemp-&mktemp-version;</title>
<?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
files in shell scripts.</para>
<segmentedlist>
<segtitle>&buildtime;</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>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Coreutils, Make, and Patch</seg></seglistitem>
<seglistitem>
<seg>Coreutils, Make, and Patch</seg>
</seglistitem>
</segmentedlist>
</sect2>
<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>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure options:</title>
<varlistentry>
<term><parameter>--with-libc</parameter></term>
<listitem><para>This causes the <command>mktemp</command> program to
use the <emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis>
functions from the system C library instead of its own implementation of them.
</para></listitem>
<listitem>
<para>This causes the <command>mktemp</command> program to use the
<emphasis>mkstemp</emphasis> and <emphasis>mkdtemp</emphasis>
functions from the system C library instead of its own implementation
of them. </para>
</listitem>
</varlistentry>
</variablelist>
<para>Compile the package:</para>
@ -64,23 +82,30 @@ make install-tempfile</userinput></screen>
</sect2>
<sect2 id="contents-mktemp" role="content"><title>Contents of Mktemp</title>
<sect2 id="contents-mktemp" role="content">
<title>Contents of Mktemp</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>mktemp and tempfile</seg></seglistitem>
<seglistitem>
<seg>mktemp and tempfile</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="mktemp">
<term><command>mktemp</command></term>
<listitem>
<para>Creates temporary files in a secure manner; it is used in scripts</para>
<indexterm zone="ch-system-mktemp mktemp"><primary sortas="b-mktemp">mktemp</primary></indexterm>
<para>Creates temporary files in a secure manner; it is used in
scripts</para>
<indexterm zone="ch-system-mktemp mktemp">
<primary sortas="b-mktemp">mktemp</primary>
</indexterm>
</listitem>
</varlistentry>
@ -88,13 +113,16 @@ make install-tempfile</userinput></screen>
<term><command>tempfile</command></term>
<listitem>
<para>Creates temporary files in a less secure manner than
<command>mktemp</command>; it is installed for backwards-compatibility</para>
<indexterm zone="ch-system-mktemp tempfile"><primary sortas="b-tempfile">tempfile</primary></indexterm>
<command>mktemp</command>; it is installed for
backwards-compatibility</para>
<indexterm zone="ch-system-mktemp tempfile">
<primary sortas="b-tempfile">tempfile</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

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

@ -1,29 +1,44 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-module-init-tools" role="wrap">
<title>Module-Init-Tools-&module-init-tools-version;</title>
<?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
modules in Linux kernels greater than or equal to version 2.5.47.</para>
<segmentedlist>
<segtitle>&buildtime;</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>
<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>
</sect2>
<sect2 role="installation">
@ -51,16 +66,20 @@ make distclean</userinput></screen>
</sect2>
<sect2 id="contents-module-init-tools" role="content"><title>Contents of Module-Init-Tools</title>
<sect2 id="contents-module-init-tools" role="content">
<title>Contents of Module-Init-Tools</title>
<segmentedlist>
<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>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -68,17 +87,23 @@ insmod.static, lsmod, modinfo, modprobe, and rmmod</seg></seglistitem>
<term><command>depmod</command></term>
<listitem>
<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
automatically load the required modules</para>
<indexterm zone="ch-system-module-init-tools depmod"><primary sortas="b-depmod">depmod</primary></indexterm>
existing set of modules; this dependency file is used by
<command>modprobe</command> to automatically load the required
modules</para>
<indexterm zone="ch-system-module-init-tools depmod">
<primary sortas="b-depmod">depmod</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="generate-modprobe.conf">
<term><command>generate-modprobe.conf</command></term>
<listitem>
<para>Creates a modprobe.conf file from an existing 2.2 or 2.4 module setup</para>
<indexterm zone="ch-system-module-init-tools generate-modprobe.conf"><primary sortas="b-generate-modprobe.conf">generate-modprobe.conf</primary></indexterm>
<para>Creates a modprobe.conf file from an existing 2.2 or 2.4 module
setup</para>
<indexterm zone="ch-system-module-init-tools generate-modprobe.conf">
<primary sortas="b-generate-modprobe.conf">generate-modprobe.conf</primary>
</indexterm>
</listitem>
</varlistentry>
@ -86,7 +111,9 @@ automatically load the required modules</para>
<term><command>insmod</command></term>
<listitem>
<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>
</varlistentry>
@ -94,8 +121,9 @@ automatically load the required modules</para>
<term><command>insmod.static</command></term>
<listitem>
<para>A statically compiled version of <command>insmod</command></para>
<indexterm zone="ch-system-module-init-tools insmod.static"><primary
sortas="b-insmod.static">insmod.static</primary></indexterm>
<indexterm zone="ch-system-module-init-tools insmod.static">
<primary sortas="b-insmod.static">insmod.static</primary>
</indexterm>
</listitem>
</varlistentry>
@ -103,7 +131,9 @@ sortas="b-insmod.static">insmod.static</primary></indexterm>
<term><command>lsmod</command></term>
<listitem>
<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>
</varlistentry>
@ -112,7 +142,9 @@ sortas="b-insmod.static">insmod.static</primary></indexterm>
<listitem>
<para>Examines an object file associated with a kernel module and
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>
</varlistentry>
@ -121,7 +153,9 @@ displays any information that it can glean</para>
<listitem>
<para>Uses a dependency file, created by
<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>
</varlistentry>
@ -129,12 +163,14 @@ displays any information that it can glean</para>
<term><command>rmmod</command></term>
<listitem>
<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>
</varlistentry>
</variablelist>
</sect2>
</sect1>

150
chapter06/ncurses.xml
View File

@ -1,29 +1,44 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-ncurses" role="wrap">
<title>Ncurses-&ncurses-version;</title>
<?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
handling of character screens.</para>
<segmentedlist>
<segtitle>&buildtime;</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>
<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>
</sect2>
<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>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure option:</title>
<varlistentry>
<term><parameter>--enable-widec</parameter></term>
<listitem><para>This switch causes wide-character libraries
(e.g., <filename class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
to be built instead of normal ones
(e.g., <filename class="libraryfile">libncurses.so.&ncurses-version;</filename>).
These wide-character libraries are usable in both multibyte and traditional 8-bit
locales, while normal libraries work properly only in 8-bit locales.
Wide-character and normal libraries are source-compatible, but not
binary-compatible.</para>
<listitem>
<para>This switch causes wide-character libraries (e.g., <filename
class="libraryfile">libncursesw.so.&ncurses-version;</filename>)
to be built instead of normal ones (e.g., <filename
class="libraryfile">libncurses.so.&ncurses-version;</filename>).
These wide-character libraries are usable in both multibyte and
traditional 8-bit locales, while normal libraries work properly
only in 8-bit locales. Wide-character and normal libraries are
source-compatible, but not binary-compatible.</para>
</listitem>
</varlistentry>
<!--
<varlistentry>
<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
not to be built. Nothing in LFS and BLFS uses this library.</para>
</listitem>
</varlistentry>
-->
</variablelist>
<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 libncurses.a /usr/lib/libcurses.a</userinput></screen>
<note><para>The instructions above don't create non-wide-character Ncurses
libraries since no package installed by compiling from sources would link
against them at runtime.
If you must have such libraries because of some binary-only application,
build them with the following commands:</para>
<note>
<para>The instructions above don't create non-wide-character Ncurses
libraries since no package installed by compiling from sources would
link against them at runtime. If you must have such libraries because
of some binary-only application, build them with the following
commands:</para>
<screen role="nodump"><userinput>make distclean &amp;&amp;
./configure --prefix=/usr --with-shared --without-normal \
--without-debug --without-cxx-binding &amp;&amp;
make sources libs &amp;&amp;
cp -av lib/lib*.so.5* /usr/lib</userinput></screen>
</note>
</sect2>
<sect2 id="contents-ncurses" role="content"><title>Contents of Ncurses</title>
<sect2 id="contents-ncurses" role="content">
<title>Contents of Ncurses</title>
<segmentedlist>
<segtitle>Installed programs</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>
<seg>libcursesw.[a,so] (symlink and linker script to libncursesw.[a,so]),
libformw.[a,so], libmenuw.[a,so],
libncurses++w.a, libncursesw.[a,so], libpanelw.[a,so] and their
non-wide-character counterparts without "w" in the library names.</seg></seglistitem>
libformw.[a,so], libmenuw.[a,so], libncurses++w.a, libncursesw.[a,so],
libpanelw.[a,so] and their non-wide-character counterparts without "w"
in the library names.</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?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>
<listitem>
<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>
</varlistentry>
@ -163,7 +191,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>clear</command></term>
<listitem>
<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>
</varlistentry>
@ -171,7 +201,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>infocmp</command></term>
<listitem>
<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>
</varlistentry>
@ -179,7 +211,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>infotocap</command></term>
<listitem>
<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>
</varlistentry>
@ -187,7 +221,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<term><command>reset</command></term>
<listitem>
<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>
</varlistentry>
@ -196,7 +232,9 @@ non-wide-character counterparts without "w" in the library names.</seg></seglist
<listitem>
<para>The terminfo action checker; it is mainly used to test the
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>
</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
ncurses library routines. A terminfo file contains information on the
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>
</varlistentry>
@ -216,7 +256,9 @@ capabilities of a certain terminal</para>
<listitem>
<para>Lists all available terminal types, giving the primary name and
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>
</varlistentry>
@ -226,7 +268,9 @@ description for each</para>
<para>Makes the values of terminal-dependent capabilities available to
the shell; it can also be used to reset or initialize a terminal or
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>
</varlistentry>
@ -234,7 +278,9 @@ report its long name</para>
<term><command>tset</command></term>
<listitem>
<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>
</varlistentry>
@ -242,7 +288,9 @@ report its long name</para>
<term><filename class="libraryfile">libcurses</filename></term>
<listitem>
<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>
</varlistentry>
@ -251,8 +299,11 @@ report its long name</para>
<listitem>
<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
menu displayed during the kernel's <command>make menuconfig</command></para>
<indexterm zone="ch-system-ncurses libncurses"><primary sortas="c-libncurses">libncurses</primary></indexterm>
menu displayed during the kernel's <command>make
menuconfig</command></para>
<indexterm zone="ch-system-ncurses libncurses">
<primary sortas="c-libncurses">libncurses</primary>
</indexterm>
</listitem>
</varlistentry>
@ -260,7 +311,9 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libform</filename></term>
<listitem>
<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>
</varlistentry>
@ -268,7 +321,9 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libmenu</filename></term>
<listitem>
<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>
</varlistentry>
@ -276,9 +331,12 @@ menu displayed during the kernel's <command>make menuconfig</command></para>
<term><filename class="libraryfile">libpanel</filename></term>
<listitem>
<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>
</varlistentry>
</variablelist>
</sect2>

59
chapter06/patch.xml
View File

@ -1,30 +1,45 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-patch" role="wrap">
<title>Patch-&patch-version;</title>
<?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/>
<para>The Patch package contains a program for modifying or creating files by
applying a <quote>patch</quote> file typically created by the
<indexterm zone="ch-system-patch">
<primary sortas="a-Patch">Patch</primary>
</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>
<segmentedlist>
<segtitle>&buildtime;</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>
<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>
</sect2>
<sect2 role="installation">
@ -46,31 +61,37 @@ GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
</sect2>
<sect2 id="contents-patch" role="content"><title>Contents of Patch</title>
<sect2 id="contents-patch" role="content">
<title>Contents of Patch</title>
<segmentedlist>
<segtitle>Installed program</segtitle>
<seglistitem><seg>patch</seg></seglistitem>
<seglistitem>
<seg>patch</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="patch">
<term><command>patch</command></term>
<listitem>
<para>Modifies files according to a patch file. A patch file is normally
a difference listing created with the <command>diff</command> program. By applying
these differences to the original files, <command>patch</command> creates the patched
versions.</para>
<indexterm zone="ch-system-patch patch"><primary sortas="b-patch">patch</primary></indexterm>
<para>Modifies files according to a patch file. A patch file is
normally a difference listing created with the <command>diff</command>
program. By applying these differences to the original files,
<command>patch</command> creates the patched versions.</para>
<indexterm zone="ch-system-patch patch">
<primary sortas="b-patch">patch</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>