Miscellaneous adjustments.

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

18 files changed, 46 insertions, 38 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>
 
diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml
index 3ea1d1865..d06af25bb 100644
--- a/chapter01/changelog.xml
+++ b/chapter01/changelog.xml
@@ -109,6 +109,9 @@ devpts problems</para></listitem>
 <listitem><para>September 24th, 2003 [greg]: Various changes across the board
 addressing Bug 675.</para></listitem>
 
+<listitem><para>September 24th, 2003 [alex]: Appendix A - Changed the style of
+the short descriptions, and the content of most of them too.</para></listitem>
+
 <listitem><para>September 22nd, 2003 [greg]: Chapter 8 - Creating the /etc/fstab
 file: Made mounting devpts the default.</para></listitem>
 
@@ -117,20 +120,20 @@ mii-tool compilation</para></listitem>
 
 <listitem><para>September 22nd, 2003 [jwrober]: Chapter 5 - Updated the Why 
 Static page to more accurately represent the difference between statically and 
-dynamically linked binaries. Thanks to Ian Molton for point this out.  Fixes 
+dynamically linked binaries. Thanks to Ian Molton for pointing this out.  Fixes
 Bug 602.</para></listitem>
 
 <listitem><para>September 22nd, 2003 [jeremy]: Removed the make 
-command from DejaGNU, since it performs nothing.</para></listitem>
+command from DejaGnu, since it performs nothing.</para></listitem>
 
-<listitem><para>September 22nd, 2003 [jeremy]: Removed the -k from TCL's make
+<listitem><para>September 22nd, 2003 [jeremy]: Removed the -k from Tcl's make
 check, since it's not expected to have failures anymore</para></listitem>
 
 <listitem><para>September 22nd, 2003 [jeremy]: Changed the reference to the
-man hint to a pointer to BLFS</para></listitem>
+man hint to a pointer to BLFS.</para></listitem>
 
-<listitem><para>September 22nd, 2003 [jeremy]: added a note to remember to
-mount devpts if you exit and re-enter chroot</para></listitem>
+<listitem><para>September 22nd, 2003 [jeremy]: Added a note to remember to
+mount devpts if you exit and re-enter chroot.</para></listitem>
 
 <listitem><para>September 22nd, 2003 [jeremy]: removed make check from patch
 and diffutils, since these tests perform no actions.</para></listitem>
@@ -144,7 +147,7 @@ to gcc-3.3.1-specs-2.patch. Ncurses: added --enable-overwrite and description.
 </para></listitem>
 
 <listitem><para>September 19th, 2003 [jeremy]: Corrected bash tags for proper
-use of the +h flag to bash</para></listitem>
+use of the +h flag to bash.</para></listitem>
 
 <listitem><para>September 19th, 2003 [jwrober]: Various updates to the 
 acknowledgements page.</para></listitem>
diff --git a/chapter06/coreutils-inst.xml b/chapter06/coreutils-inst.xml
index 9bcc4ea41..6e28571f7 100644
--- a/chapter06/coreutils-inst.xml
+++ b/chapter06/coreutils-inst.xml
@@ -25,7 +25,7 @@ provided by Net-tools. Prevent its installation by applying a patch:</para>
 
 <para>This package has a test suite available which can perform a number of
 checks to ensure it built correctly. However, this particular test suite makes
-some assumptions that aren't quite vaild at this early stage of Chapter 6. We
+some assumptions that aren't quite valid at this early stage of Chapter 6. We
 therefore make a few adjustments to allow the tests to run properly. Should you
 choose not to run the test suite, skip down to "Install the package". The
 following commands will prepare us for the test suite. Create two dummy groups
diff --git a/chapter06/diffutils-inst.xml b/chapter06/diffutils-inst.xml
index dc3bf8178..49009a290 100644
--- a/chapter06/diffutils-inst.xml
+++ b/chapter06/diffutils-inst.xml
@@ -11,7 +11,7 @@
 
 <para><screen><userinput>make</userinput></screen></para>
 
-<para>And install the package:</para>
+<para>And install it:</para>
 
 <para><screen><userinput>make install</userinput></screen></para>
 
diff --git a/chapter06/patch-inst.xml b/chapter06/patch-inst.xml
index 3aac8b565..08b78c894 100644
--- a/chapter06/patch-inst.xml
+++ b/chapter06/patch-inst.xml
@@ -11,7 +11,7 @@
 
 <para><screen><userinput>make</userinput></screen></para>
 
-<para>And install the package:</para>
+<para>And install it:</para>
 
 <para><screen><userinput>make install</userinput></screen></para>