Miscellaneous adjustments.

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

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

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>

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

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>
 

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>

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,

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>

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>

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>
 

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>
 

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.

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>

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>

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>
 

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>

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

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>
 

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>