HEAD: Retagged the Contents of ... sections.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3621 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

1 files changed, 293 insertions, 75 deletions

diff --git a/chapter06/glibc.xml b/chapter06/glibc.xml
index cc59f02c0..f3b7d108f 100644
--- a/chapter06/glibc.xml
+++ b/chapter06/glibc.xml
@@ -239,202 +239,420 @@ following:</para>
 </sect2>
 
 
-<sect2 id="contents-glibc"><title>Contents of Glibc</title>
+<sect2 id="contents-glibc" role="content"><title>Contents of Glibc</title>
 
-<para><emphasis>Installed programs</emphasis>: catchsegv, gencat, getconf,
+<segmentedlist>
+<segtitle>Installed programs</segtitle>
+<segtitle>Installed libraries</segtitle>
+<seglistitem><seg>catchsegv, gencat, getconf,
 getent, glibcbug, iconv, iconvconfig, ldconfig, ldd, lddlibc4, locale,
 localedef, mtrace, nscd, nscd_nischeck, pcprofiledump, pt_chown, rpcgen,
-rpcinfo, sln, sprof, tzselect, xtrace, zdump and zic</para>
-
-<para><emphasis>Installed libraries</emphasis>: ld.so, libBrokenLocale.[a,so],
+rpcinfo, sln, sprof, tzselect, xtrace, zdump and zic</seg>
+<seg>ld.so, libBrokenLocale.[a,so],
 libSegFault.so, libanl.[a,so], libbsd-compat.a, libc.[a,so], libc_nonshared.a,
 libcrypt.[a,so], libdl.[a,so], libg.a, libieee.a, libm.[a,so], libmcheck.a,
 libmemusage.so, libnsl.a, libnss_compat.so, libnss_dns.so, libnss_files.so,
 libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so, libpcprofile.so,
 libpthread.[a,so], libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so
-and libutil.[a,so]</para>
-
-</sect2>
-
+and libutil.[a,so]</seg></seglistitem>
+</segmentedlist>
 
-<sect2><title>Short descriptions</title>
+<variablelist><title>Short descriptions</title>
 
+<varlistentry>
+<term id="catchsegv"><command>catchsegv</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc catchsegv"><primary sortas="b-catchsegv">catchsegv</primary></indexterm>
-<para id="catchsegv"><command>catchsegv</command> can be used to create a stack trace
+<para>can be used to create a stack trace
 when a program terminates with a segmentation fault.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="gencat"><command>gencat</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc gencat"><primary sortas="b-gencat">gencat</primary></indexterm>
-<para id="gencat"><command>gencat</command> generates message catalogues.</para>
+<para>generates message catalogues.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="getconf"><command>getconf</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc getconf"><primary sortas="b-getconf">getconf</primary></indexterm>
-<para id="getconf"><command>getconf</command> displays the system configuration values
-for file system specific variables.</para>
+<para>displays the system configuration values for file system specific variables.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="getent"><command>getent</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc getent"><primary sortas="b-getent">getent</primary></indexterm>
-<para id="getent"><command>getent</command> gets entries from an administrative
-database.</para>
+<para>gets entries from an administrative database.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="glibcbug"><command>glibcbug</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc glibcbug"><primary sortas="b-glibcbug">glibcbug</primary></indexterm>
-<para id="glibcbug"><command>glibcbug</command> creates a bug report and mails it to the
-bug email address.</para>
+<para>creates a bug report and mails it to the bug email address.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="iconv"><command>iconv</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc iconv"><primary sortas="b-iconv">iconv</primary></indexterm>
-<para id="iconv"><command>iconv</command> performs character set conversion.</para>
+<para>performs character set conversion.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="iconvconfig"><command>iconvconfig</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc iconvconfig"><primary sortas="b-iconvconfig">iconvconfig</primary></indexterm>
-<para id="iconvconfig"><command>iconvconfig</command> creates fastloading iconv module
-configuration file.</para>
+<para>creates fastloading iconv module configuration file.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="ldconfig"><command>ldconfig</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc ldconfig"><primary sortas="b-ldconfig">ldconfig</primary></indexterm>
-<para id="ldconfig"><command>ldconfig</command> configures the dynamic linker runtime
-bindings.</para>
+<para>configures the dynamic linker runtime bindings.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="ldd"><command>ldd</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc ldd"><primary sortas="b-ldd">ldd</primary></indexterm>
-<para id="ldd"><command>ldd</command> reports which shared libraries are required
+<para>reports which shared libraries are required
 by each given program or shared library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="lddlibc4"><command>lddlibc4</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc lddlibc4"><primary sortas="b-lddlibc4">lddlibc4</primary></indexterm>
-<para id="lddlibc4"><command>lddlibc4</command> assists ldd with object files.</para>
+<para>assists ldd with object files.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="locale"><command>locale</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc locale"><primary sortas="b-locale">locale</primary></indexterm>
-<para id="locale"><command>locale</command> is a Perl program that tells the compiler
+<para>is a Perl program that tells the compiler
 to enable or disable the use of POSIX locales for built-in operations.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="localedef"><command>localedef</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc localedef"><primary sortas="b-localedef">localedef</primary></indexterm>
-<para id="localedef"><command>localedef</command> compiles locale specifications.</para>
+<para>compiles locale specifications.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="mtrace"><command>mtrace</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc mtrace"><primary sortas="b-mtrace">mtrace</primary></indexterm>
-<para id="mtrace"><command>mtrace</command>...</para>
+<para>...</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="nscd"><command>nscd</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc nscd"><primary sortas="b-nscd">nscd</primary></indexterm>
-<para id="nscd"><command>nscd</command> is a name service cache daemon providing a
+<para>is a name service cache daemon providing a
 cache for the most common name service requests.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="nscd_nischeck"><command>nscd_nischeck</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc nscd_nischeck"><primary sortas="b-nscd_nischeck">nscd_nischeck</primary></indexterm>
-<para id="nscd_nischeck"><command>nscd_nischeck</command> checks whether or not secure mode
-is necessary for NIS+ lookup.</para>
+<para>checks whether or not secure mode is necessary for NIS+ lookup.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="pcprofiledump"><command>pcprofiledump</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc pcprofiledump"><primary sortas="b-pcprofiledump">pcprofiledump</primary></indexterm>
-<para id="pcprofiledump"><command>pcprofiledump</command> dumps information generated by
-PC profiling.</para>
+<para>dumps information generated by PC profiling.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="pt_chown"><command>pt_chown</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc pt_chown"><primary sortas="b-pt_chown">pt_chown</primary></indexterm>
-<para id="pt_chown"><command>pt_chown</command> is a helper program for grantpt to set
+<para>is a helper program for grantpt to set
 the owner, group and access permissions of a slave pseudo terminal.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="rpcgen"><command>rpcgen</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc rpcgen"><primary sortas="b-rpcgen">rpcgen</primary></indexterm>
-<para id="rpcgen"><command>rpcgen</command> generates C code to implement the
-RPC protocol.</para>
+<para>generates C code to implement the RPC protocol.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="rpcinfo"><command>rpcinfo</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc rpcinfo"><primary sortas="b-rpcinfo">rpcinfo</primary></indexterm>
-<para id="rpcinfo"><command>rpcinfo</command> makes an RPC call to an RPC server.</para>
+<para>makes an RPC call to an RPC server.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="sln"><command>sln</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc sln"><primary sortas="b-sln">sln</primary></indexterm>
-<para id="sln"><command>sln</command> is used to make symbolic links. The program
+<para>is used to make symbolic links. The program
 is statically linked, so it is useful for making symbolic links to dynamic
 libraries if the dynamic linking system for some reason is nonfunctional.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="sprof"><command>sprof</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc sprof"><primary sortas="b-sprof">sprof</primary></indexterm>
-<para id="sprof"><command>sprof</command> reads and displays shared object profiling
-data.</para>
+<para>reads and displays shared object profiling data.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="tzselect"><command>tzselect</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc tzselect"><primary sortas="b-tzselect">tzselect</primary></indexterm>
-<para id="tzselect"><command>tzselect</command> asks the user about the location of the
+<para>asks the user about the location of the
 system and reports the corresponding time zone description.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="xtrace"><command>xtrace</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc xtrace"><primary sortas="b-xtrace">xtrace</primary></indexterm>
-<para id="xtrace"><command>xtrace</command> traces the execution of a program by
+<para>traces the execution of a program by
 printing the currently executed function.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="zdump"><command>zdump</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc zdump"><primary sortas="b-zdump">zdump</primary></indexterm>
-<para id="zdump"><command>zdump</command> is the time zone dumper.</para>
+<para>is the time zone dumper.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="zic"><command>zic</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc zic"><primary sortas="b-zic">zic</primary></indexterm>
-<para id="zic"><command>zic</command> is the time zone compiler.</para>
+<para>is the time zone compiler.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="ld.so"><command>ld.so</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc ld.so"><primary sortas="c-ld.so">ld.so</primary></indexterm>
-<para id="ld.so"><command>ld.so</command> is the helper program for shared library
-executables.</para>
+<para>is the helper program for shared library executables.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libBrokenLocale"><command>libBrokenLocale</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libBrokenLocale"><primary sortas="c-libBrokenLocale">libBrokenLocale</primary></indexterm>
-<para id="libBrokenLocale"><command>libBrokenLocale</command> is used by programs, such as
-Mozilla, to solve broken locales.</para>
+<para>is used by programs, such as Mozilla, to solve broken locales.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libSegFault"><command>libSegFault</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libSegFault"><primary sortas="c-libSegFault">libSegFault</primary></indexterm>
-<para id="libSegFault"><command>libSegFault</command> is a segmentation fault signal
-handler. It tries to catch segfaults.</para>
+<para>is a segmentation fault signal handler. It tries to catch segfaults.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libanl"><command>libanl</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libanl"><primary sortas="c-libanl">libanl</primary></indexterm>
-<para id="libanl"><command>libanl</command> is an asynchronous name lookup
-library.</para>
+<para>is an asynchronous name lookup library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libbsd-compat"><command>libbsd-compat</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libbsd-compat"><primary sortas="c-libbsd-compat">libbsd-compat</primary></indexterm>
-<para id="libbsd-compat"><command>libbsd-compat</command> provides the portability needed
+<para>provides the portability needed
 in order to run certain BSD programs under Linux.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libc"><command>libc</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libc"><primary sortas="c-libc">libc</primary></indexterm>
-<para id="libc"><command>libc</command> is the main C library -- a collection of
-commonly used functions.</para>
+<para>is the main C library -- a collection of commonly used functions.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libcrypt"><command>libcrypt</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libcrypt"><primary sortas="c-libcrypt">libcrypt</primary></indexterm>
-<para id="libcrypt"><command>libcrypt</command> is the cryptography library.</para>
+<para>is the cryptography library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libdl"><command>libdl</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libdl"><primary sortas="c-libdl">libdl</primary></indexterm>
-<para id="libdl"><command>libdl</command> is the dynamic linking interface library.</para>
+<para>is the dynamic linking interface library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libg"><command>libg</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libg"><primary sortas="c-libg">libg</primary></indexterm>
-<para id="libg"><command>libg</command> is a runtime library for g++.</para>
+<para>is a runtime library for g++.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libieee"><command>libieee</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libieee"><primary sortas="c-libieee">libieee</primary></indexterm>
-<para id="libieee"><command>libieee</command> is the IEEE floating point library.</para>
+<para>is the IEEE floating point library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libm"><command>libm</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libm"><primary sortas="c-libm">libm</primary></indexterm>
-<para id="libm"><command>libm</command> is the mathematical library.</para>
+<para>is the mathematical library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libmcheck"><command>libmcheck</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libmcheck"><primary sortas="c-libmcheck">libmcheck</primary></indexterm>
-<para id="libmcheck"><command>libmcheck</command> contains code run at boot.</para>
+<para>contains code run at boot.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libmemusage"><command>libmemusage</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libmemusage"><primary sortas="c-libmemusage">libmemusage</primary></indexterm>
-<para id="libmemusage"><command>libmemusage</command> is used by memusage to help collect
+<para>is used by memusage to help collect
 information about the memory usage of a program.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libnsl"><command>libnsl</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libnsl"><primary sortas="c-libnsl">libnsl</primary></indexterm>
-<para id="libnsl"><command>libnsl</command> is the network services library.</para>
+<para>is the network services library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libnss"><command>libnss*</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libnss"><primary sortas="c-libnss*">libnss*</primary></indexterm>
-<para id="libnss"><command>libnss*</command> are the Name Service Switch libraries,
+<para>are the Name Service Switch libraries,
 containing functions for resolving host names, user names, group names,
 aliases, services, protocols,and the like.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libpcprofile"><command>libpcprofile</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libpcprofile"><primary sortas="c-libpcprofile">libpcprofile</primary></indexterm>
-<para id="libpcprofile"><command>libpcprofile</command> contains profiling functions used
+<para>contains profiling functions used
 to track the amount of CPU time spent in which source code lines.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libpthread"><command>libpthread</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libpthread"><primary sortas="c-libpthread">libpthread</primary></indexterm>
-<para id="libpthread"><command>libpthread</command> is the POSIX threads library.</para>
+<para>is the POSIX threads library.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libresolv"><command>libresolv</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libresolv"><primary sortas="c-libresolv">libresolv</primary></indexterm>
-<para id="libresolv"><command>libresolv</command> contains functions for creating,
+<para>contains functions for creating,
 sending, and interpreting packets to the Internet domain name servers.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="librpcsvc"><command>librpcsvc</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc librpcsvc"><primary sortas="c-librpcsvc">librpcsvc</primary></indexterm>
-<para id="librpcsvc"><command>librpcsvc</command>contains functions providing
-miscellaneous RPC services.</para>
+<para>contains functions providing miscellaneous RPC services.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="librt"><command>librt</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc librt"><primary sortas="c-librt">librt</primary></indexterm>
-<para id="librt"><command>librt</command> contains functions providing most of the
+<para>contains functions providing most of the
 interfaces specified by the POSIX.1b Realtime Extension.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libthread_db"><command>libthread_db</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libthread_db"><primary sortas="c-libthread_db">libthread_db</primary></indexterm>
-<para id="libthread_db"><command>libthread_db</command> contains functions useful for
+<para>contains functions useful for
 building debuggers for multi-threaded programs.</para>
+</listitem>
+</varlistentry>
 
+<varlistentry>
+<term id="libutil"><command>libutil</command></term>
+<listitem>
 <indexterm zone="ch-system-glibc libutil"><primary sortas="c-libutil">libutil</primary></indexterm>
-<para id="libutil"><command>libutil</command> contains code for "standard" functions
-used in many different Unix utilities.</para>
+<para>contains code for "standard" functions used in many different Unix utilities.</para>
+</listitem>
+</varlistentry>
+</variablelist>
 
 </sect2>
 
-
-
 </sect1>