Miscellaneous adjustments.

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

14 files changed, 33 insertions, 28 deletions

diff --git a/appendixa/bootscripts-desc.xml b/appendixa/bootscripts-desc.xml
index 8dc676fb3..83ff56681 100644
--- a/appendixa/bootscripts-desc.xml
+++ b/appendixa/bootscripts-desc.xml
@@ -4,7 +4,7 @@
 
 <para>(Last checked against version &bootscripts-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Script descriptions</title>
 
 <para>The <command>checkfs</command> script checks the file systems just
 before they are mounted (with the exception of journal and network based file
diff --git a/appendixa/bzip2-desc.xml b/appendixa/bzip2-desc.xml
index cbd8171ab..6f02f43bd 100644
--- a/appendixa/bzip2-desc.xml
+++ b/appendixa/bzip2-desc.xml
@@ -32,7 +32,7 @@ bzip2 files.</para>
 
 <sect3><title>Library file descriptions</title>
 
-<para><command>libbz2</command> is the library implementing lossless,
+<para><command>libbz2*</command> is the library implementing lossless,
 block-sorting data compression, using the Burrows-Wheeler algorithm.</para>
 
 </sect3>
diff --git a/appendixa/file-desc.xml b/appendixa/file-desc.xml
index a49c1f686..ab8568760 100644
--- a/appendixa/file-desc.xml
+++ b/appendixa/file-desc.xml
@@ -1,10 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &file-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Program file description</title>
 
 <para><command>file</command> tries to classify each given file. It does
 this by performing several tests: filesystem tests, magic number tests, and
diff --git a/appendixa/flex-desc.xml b/appendixa/flex-desc.xml
index 24f9832e9..ea6181669 100644
--- a/appendixa/flex-desc.xml
+++ b/appendixa/flex-desc.xml
@@ -19,7 +19,7 @@ exclusively for C++ scanners.</para>
 
 <sect3><title>Library file descriptions</title>
 
-<para><command>libfl</command> is the flex library.</para>
+<para><command>libfl.a</command> is the flex library.</para>
 
 </sect3>
 
diff --git a/appendixa/grub-shortdesc.xml b/appendixa/grub-shortdesc.xml
index 194130d1f..e7e9e69b8 100644
--- a/appendixa/grub-shortdesc.xml
+++ b/appendixa/grub-shortdesc.xml
@@ -1,5 +1,12 @@
 <sect2><title>Contents of Grub</title>
 
-<para>(To be determined)</para>
+<para>(Last checked against version &grub-contversion;.)</para>
+
+<para>The Grub package contains a bootloader.</para>
+
+<para>Grub installs the following:</para>
+
+<sect3><title>Program Files</title>
+<para>grub, grub-install, grub-md5-crypt, grub-terminfo and mbchk</para></sect3>
 
 </sect2>
diff --git a/appendixa/m4-desc.xml b/appendixa/m4-desc.xml
index 04136d7a0..7adcf90c8 100644
--- a/appendixa/m4-desc.xml
+++ b/appendixa/m4-desc.xml
@@ -7,7 +7,7 @@
 <sect3><title>Program file descriptions</title>
 
 <para><command>m4</command> copies the given files
-while expanding the macros that it contains. These macros are either built-in
+while expanding the macros that they contain. These macros are either built-in
 or user-defined and can take any number of arguments. Besides just doing macro
 expansion, m4 has built-in functions for including named files, running Unix
 commands, doing integer arithmetic, manipulating text in various ways,
diff --git a/appendixa/make-desc.xml b/appendixa/make-desc.xml
index 29904c72e..91e00f196 100644
--- a/appendixa/make-desc.xml
+++ b/appendixa/make-desc.xml
@@ -1,10 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &make-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Program file description</title>
 
 <para><command>make</command> automatically determines which pieces of a
 large package need to be recompiled, and then issues the relevant commands.</para>
diff --git a/appendixa/makedev-desc.xml b/appendixa/makedev-desc.xml
index db04fbe63..a93e42771 100644
--- a/appendixa/makedev-desc.xml
+++ b/appendixa/makedev-desc.xml
@@ -1,10 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &makedev-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Program file description</title>
 
 <para><command>MAKEDEV</command> is a script for creating the necessary
 static device nodes, usually residing in the <filename>/dev</filename>
diff --git a/appendixa/man-desc.xml b/appendixa/man-desc.xml
index 4f9273dca..ae1863c49 100644
--- a/appendixa/man-desc.xml
+++ b/appendixa/man-desc.xml
@@ -1,6 +1,6 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Description</title>
+<sect2><title>Descriptions</title>
 
 <para>(Last checked against version &man-contversion;.)</para>
 
diff --git a/appendixa/manpages-desc.xml b/appendixa/manpages-desc.xml
index 31df01deb..fb4080ece 100644
--- a/appendixa/manpages-desc.xml
+++ b/appendixa/manpages-desc.xml
@@ -1,15 +1,14 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &man-pages-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Support file description</title>
 
-<sect4><title>manual pages</title>
-<para>Examples of provided manual pages are the manual pages describing all
-the C and C++ functions, a few important /dev/ files and
-more.</para></sect4>
+<para>Examples of provided <emphasis>manual pages</emphasis> are the pages
+describing all the C and C++ functions, important device files, and important
+configuration files.</para>
 
 </sect3>
 
diff --git a/appendixa/patch-desc.xml b/appendixa/patch-desc.xml
index aa966eebf..2152e55f5 100644
--- a/appendixa/patch-desc.xml
+++ b/appendixa/patch-desc.xml
@@ -1,10 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &patch-contversion;.)</para>
 
-<sect3><title>Program files descriptions</title>
+<sect3><title>Program file description</title>
 
 <para><command>patch</command> modifies files according to a patch file.
 A patch file normally is a difference listing created with the diff program.
diff --git a/appendixa/sed-desc.xml b/appendixa/sed-desc.xml
index c66d8fed8..c2545befc 100644
--- a/appendixa/sed-desc.xml
+++ b/appendixa/sed-desc.xml
@@ -1,10 +1,10 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &sed-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Program file description</title>
 
 <para><command>sed</command> is used to filter and transform text files
 in a single pass.</para>
diff --git a/appendixa/zlib-desc.xml b/appendixa/zlib-desc.xml
index 3a1631016..9b582bc03 100644
--- a/appendixa/zlib-desc.xml
+++ b/appendixa/zlib-desc.xml
@@ -1,12 +1,12 @@
 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
 
-<sect2><title>Descriptions</title>
+<sect2><title>Description</title>
 
 <para>(Last checked against version &zlib-contversion;.)</para>
 
-<sect3><title>Program file descriptions</title>
+<sect3><title>Library file description</title>
 
-<para><command>libz</command> contains compression and uncompression
+<para><command>libz*</command> contains compression and uncompression
 functions used by some programs.</para>
 
 </sect3>
diff --git a/appendixa/zlib-shortdesc.xml b/appendixa/zlib-shortdesc.xml
index a22590848..d8fc72385 100644
--- a/appendixa/zlib-shortdesc.xml
+++ b/appendixa/zlib-shortdesc.xml
@@ -2,9 +2,8 @@
 
 <para>(Last checked against version &zlib-contversion;.)</para>
 
-<para>The Zlib package contains the zlib library, which
-is used by many programs for its compression and uncompression
-functions.</para>
+<para>The Zlib package contains the libz library, which is used by some
+programs for its compression and uncompression functions.</para>
 
 <para>Zlib installs the following:</para>