[Bug 190] reorganise and sync descriptions

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

1 files changed, 184 insertions, 8 deletions

diff --git a/appendixa/glibc-desc.xml b/appendixa/glibc-desc.xml
index d456652aa..503932016 100644
--- a/appendixa/glibc-desc.xml
+++ b/appendixa/glibc-desc.xml
@@ -1,13 +1,137 @@
-<sect2>
-<title>Contents</title>
+<sect2><title>Contents of glibc-&glibc-contversion;</title>
 
-<para>The Glibc package contains the GNU C Library.</para>
+<sect3><title>Program Files</title>
 
-</sect2>
+<para>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></sect3>
+
+<sect3><title>Descriptions</title>
+
+<sect4><title>catchsegv</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>gencat</title>
+<para>gencat generates message catalogues.</para></sect4>
+
+<sect4><title>getconf</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>getent</title>
+<para>getent gets entries from an administrative database.</para></sect4>
+
+<sect4><title>glibcbug</title>
+<para>glibcbug creates a bug report about glibc and and mails it to the 
+bug email address.</para></sect4>
+
+<sect4><title>iconv</title>
+<para>iconv performs character set conversion.</para></sect4>
+
+<sect4><title>iconvconfig</title>
+<para>iconvconfig creates fastloading iconv module 
+configuration file.</para></sect4>
+
+<sect4><title>ldconfig</title>
+<para>ldconfig configures the dynamic linker run time bindings.</para></sect4>
+
+<sect4><title>ldd</title>
+<para>ldd prints the shared libraries required by each program or shared
+library specified on the command line.</para></sect4>
+
+<sect4><title>lddlibc4</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>locale</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>localedef</title>
+<para>localedef compiles locale specifications.</para></sect4>
+
+<sect4><title>mtrace</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>nscd</title>
+<para>nscd is a daemon that provides a cache for the most common name
+service requests.</para></sect4>
+
+<sect4><title>nscd_nischeck</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>pcprofiledump</title>
+<para>pcprofiledump dumps information generated by 
+PC profiling.</para></sect4>
+
+<sect4><title>pt_chown</title>
+<para>pt_chown sets the owner, group and access permission of the
+slave pseudo terminal corresponding to the master pseudo terminal passed 
+on file descriptor `3'.  This is the helper program for the `grantpt' 
+function.  It is not intended to be run directly 
+from the command line.</para></sect4>
+
+<sect4><title>rpcgen</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>rpcinfo</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>sln</title>
+<para>sln symbolically links dest to source.  It is statically linked,
+needing no dynamic linking at all.  Thus sln is useful to make symbolic 
+links to dynamic libraries if the dynamic linking system for some reason 
+is nonfunctional.</para></sect4>
+
+<sect4><title>sprof</title>
+<para>sprof reads and displays shared object profiling data.</para></sect4>
+
+<sect4><title>tzselect</title>
+<para>tzselect asks the user for information about the current location and 
+outputs the resulting time zone description to standard output.</para></sect4>
+
+<sect4><title>xtrace</title>
+<para>xtrace traces execution of program by printing the currently executed
+function.</para></sect4>
+
+<sect4><title>zdump</title>
+<para>zdump is the time zone dumper.</para></sect4>
 
-<sect2><title>Description</title>
+<sect4><title>zic</title>
+<para>zic is the time zone compiler.</para></sect4>
 
-<para>The C Library is a collection of commonly used functions in programs.
+</sect3>
+
+<sect3><title>Library Files</title>
+<para>ld.so, libBrokenLocale.[a,so], libBrokenLocale_p.a,
+libSegFault.so, libanl.[a,so], libanl_p.a, libbsd-compat.a, libc.[a,so],
+libc_nonshared.a, libc_p.a, libcrypt.[a,so], libcrypt_p.a, libdl.[a,so],
+libdl_p.a, libg.a, libieee.a, libm.[a,so], libm_p.a, libmcheck.a,
+libmemusage.so, libnsl.a, libnsl_p.a, libnss_compat.so, libnss_dns.so,
+libnss_files.so, libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so,
+libpcprofile.so, libpthread.[a,so], libpthread_p.a, libresolv.[a,so],
+libresolv_p.a, librpcsvc.a, librpcsvc_p.a, librt.[a,so], librt_p.a,
+libthread_db.so, libutil.[a,so] and libutil_p.a</para></sect3>
+
+<sect3><title>Descriptions</title>
+
+<sect4><title>ld.so</title>
+<para>ld.so is the helper program for shared library 
+executables.</para></sect4>
+
+<sect4><title>libBrokenLocale.[a,so], libBrokenLocale_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libSegFault.so</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libanl.[a,so], libanl_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libbsd-compat.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libc.[a,so], libc_nonshared.a, libc_p.a</title>
+<para>These files constitute the main C library.  The C Library is a
+collection of commonly used functions in programs.
 This way a programmer doesn't need to create his own functions for every
 single task. The most common things like writing a string to the screen
 are already present and at the disposal of the programmer.</para>
@@ -18,9 +142,61 @@ library, the code from the C library will be copied into the executable
 file. When a program uses a dynamic library, that executable will not
 contain the code from the C library, but  instead a routine that loads
 the functions from the library at the time the program is run. This
-means a significant decrease in the file size of a program. The 
+means a significant decrease in the file size of a program. The
 documentation that comes with the C Library describes this in more
-detail, as it is too complicated to explain here in one or two lines.</para>
+detail, as it is too complicated to explain here in one or two
+lines.</para></sect4>
+
+<sect4><title>libcrypt.[a,so], libcrypt_p.a</title>
+<para>libcrypt is the cryptography library.</para></sect4>
+
+<sect4><title>libdl.[a,so], libdl_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libg.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libieee.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libm.[a,so], libm_p.a</title>
+<para>libm is the mathematical library.</para></sect4>
+
+<sect4><title>libmcheck.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libmemusage.so</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libnsl.a, libnsl_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libnss_compat.so, libnss_dns.so, libnss_files.so, 
+libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so</title>
+<para> </para></sect4>
+
+<sect4><title>libpcprofile.so</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libpthread.[a,so], libpthread_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libresolv.[a,so], libresolv_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>librpcsvc.a, librpcsvc_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>librt.[a,so], librt_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libthread_db.so</title>
+<para>No description is currently available.</para></sect4>
+
+<sect4><title>libutil.[a,so], libutil_p.a</title>
+<para>No description is currently available.</para></sect4>
+
+</sect3>
 
 </sect2>