Fixing some typos, adding a little markup, and other random retouches.

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

appendixa/autoconf-shortdesc.xml

@@ -1,8 +1,7 @@
 <sect2><title>Contents of Autoconf</title>
 
 <para>Last checked against version &autoconf-contversion;.</para>
-<para>
+<para>Autoconf produces shell scripts which automatically configure source
-  Autoconf produces shell scripts which automatically configure source
 code.</para>
 
 <para>Autoconf installs the following:</para>

chapter01/changelog.xml

@@ -206,7 +206,7 @@ Coreutils: Only test the non-root stuff in Chapter 05, but test everything
 in Chapter 06.</para></listitem>
 
 <listitem><para>May 21st, 2003 [winkie]: Chapter 05 - Installing Expect:
-Don't both passing anything more than --prefix=/stage1. None of it is
+Don't bother passing anything more than --prefix=/stage1. None of it is
 needed.</para></listitem>
 
 <listitem><para>May 16th, 2003 [gerard]: Chapter 06: Net-tools: Changed
@@ -225,24 +225,24 @@ Added <userinput>CPPFLAGS=-D_GNU_SOURCE</userinput> before
 <listitem><para>May 13th, 2003 [gerard]: Chapter 06 - Basic Network:
 Changed the single quotes to double quotes in the echo command. Without it,
 $(hostname) won't expand which defeats the sole purpose of this command -
-to make perl's hostname check work.</para></listitem>
+to make Perl's hostname check work.</para></listitem>
 
 <listitem><para>May 13th, 2003 [winkie]: Removed all occurrences &amp;&amp;.
 Updated bug syntax. Added "make check/test" where necessary in Chapter
 6.</para></listitem>
 
-<listitem><para>May 13th, 2003 [winkie]: Applied "Changing ownership"
+<listitem><para>May 13th, 2003 [winkie]: Chapter 06: Applied "Changing
-patch to polish the text. Closes bug #511.</para></listitem>
+ownership" patch to polish the text. Closes bug #511.</para></listitem>
 
-<listitem><para>May 13th, 2003 [winkie]: Applied "Configuring system
+<listitem><para>May 13th, 2003 [winkie]: Chapter 06: Applied "Configuring
-components" patch to polish the text. Closes bug #510.</para></listitem>
+system components" patch to polish the text. Closes bug #510.</para></listitem>
 
 <listitem><para>May 13th, 2003 [gerard]: Chapter 06: Removed TCL, Expect
 and DejaGNU. Nothing uses this once past GCC in chapter 6. The versions
 in /stage1/bin do the job just fine.</para></listitem>
 
 <listitem><para>May 13th, 2003 [winkie]: Chapter 06 - Installing Shadow:
-touch the /usr/bin/passwd file before installation. Not doing so results in
+Touching the /usr/bin/passwd file before installation. Not doing so results in
 Shadow thinking passwd will be in /bin/passwd.</para></listitem>
 
 <listitem><para>May 13th, 2003 [winkie]: Chapter 06 - Installing Procps:
@@ -280,8 +280,8 @@ first place.</para></listitem>
 gzip-1.3.5, and tar-1.13.25.</para></listitem>
 
 <listitem><para>May 12th, 2003 [winkie]: Chapter 05 - Installing Perl:
-Add extra commands to build certain modules into Perl. This is to
+Added extra commands to build certain modules into Perl. This is to accomodate
-accomadate the Coreutils "make check". Partially fixes bug #528.</para></listitem>
+the Coreutils "make check". Partially fixes bug #528.</para></listitem>
 
 <listitem><para>May 12th, 2003 [winkie]: Chapter 05 - Installing Gzip:
 Nothing in Chapter 6 checks for or uses the uncompress command,
@@ -296,8 +296,7 @@ Lfs-Utils: Removed. The only package that checks for mktemp before it is
 installed is GCC, and that's only for gccbug.</para></listitem>
 
 <listitem><para>May 11th, 2003 [gerard]: Chapter 06 - GCC-2.95.3: Added
---enable-threads=posix as well to complete the C++
+--enable-threads=posix as well to complete the C++ addition.</para></listitem>
-addition.</para></listitem>
 
 <listitem><para>May 11th, 2003 [gerard]: Chapter 06 - GCC-2.95.3: Added
 --enable-languages=c,c++ to fix that gcc's version bug with regards to
@@ -397,7 +396,7 @@ gcc and compiling zlib with -fPIC).</para></listitem>
 pass2, locking glibc and adjusting toolchain): Change tooldir to /stage1
 (likewise we use tooldir=/usr in chapter 6).</para></listitem>
 
-<listitem><para>May 10th, 2003 [gerard]: Chaper 05 - Kernel headers:
+<listitem><para>May 10th, 2003 [gerard]: Chapter 05 - Kernel headers:
 Removed the usage of <userinput>cp -H</userinput> because there are
 distributions out there that do not know about the
 <userinput>-H</userinput> option.</para></listitem>
@@ -406,10 +405,10 @@ distributions out there that do not know about the
 gcc-3.2.3-specs-3.patch.</para></listitem>
 
 <listitem><para>May 10th, 2003 [gerard]: Chapter 06 - Adjusting toolchain:
-Made it more architecture independant.</para></listitem>
+Made it more architecture-independent.</para></listitem>
 
 <listitem><para>May 10th, 2003 [gerard]: Chapter 05 - Locking in Glibc:
-Made it more architecture independant.</para></listitem>
+Made it more architecture-independent.</para></listitem>
 
 <listitem><para>May 7th, 2003 [gerard]: Removed GCC No Debug patches. No
 longer assume gcc-core and gcc-g++ packages are downloaded, so added
@@ -424,7 +423,7 @@ Newer versions just don't work properly.</para></listitem>
 <listitem><para>May 5th, 2003 [gerard]: Removed zlib installation from
 chapter 5 (its inclusion was a mistake).</para></listitem>
 
-<listitem><para>May 5th, 2003 [gerard]: Various buf fixes that were
+<listitem><para>May 5th, 2003 [gerard]: Various bug fixes that were
 introduced during the pure-lfs integration.</para></listitem>
 
 <listitem><para>May 2nd, 2003 [gerard]: Upgraded to: automake-1.7.4,

chapter01/how.xml

@@ -3,9 +3,9 @@
 <?dbhtml filename="how.html" dir="chapter01"?>
 
 <para>We are going to build the LFS system by using a previously installed
-Linux distribution such as Debian, SuSE, Slackware, Mandrake, RedHat, etc.
+Linux distribution such as Debian, SuSE, Slackware, Mandrake, or Red Hat.
-We will use the existing Linux system as the development platform, because
+We will use this existing Linux system as a starting platform, because we
-we need tools like a compiler, linker, text editor, and other development
+will need tools like a compiler, linker, text editor, and other development
 tools to build our system. Ordinarily, the required tools are available by
 default if we selected "development" as one of our installation options
 when we installed a Linux distribution.</para>

chapter04/chapter04.xml

@@ -9,10 +9,10 @@
 
 <para>Below is a list of packages you need to download for building a
 basic Linux system. The listed version numbers correspond to versions
-of the software that are known to work, and this book is based upon
+of the software that are <emphasis>known</emphasis> to work, and this book is
-them. Feel free to try out newer versions, but if you experience problems
+based upon them. You can try out newer versions, of course, but if you
-with those versions, please try the recommended version first before
+experience problems with those versions, use the indicated version instead.
-sending bug reports.</para>
+Often there is a reason for not using the latest version.</para>
 
 <para>All the URLs, when possible, refer to the project's page at
 <ulink url="http://www.freshmeat.net">Freshmeat.net</ulink>. The Freshmeat

chapter06/basic-net.xml

@@ -4,21 +4,22 @@
 
 <para>Here will be set up basic networking now that all the necessary
 software has been installed. There isn't all that much to do, really,
-just creating a basic /etc/hosts file, and downloading some very
+just creating a basic <filename>/etc/hosts</filename> file, and downloading
-high-quality network information files.</para>
+some high-quality network information files.</para>
 
-<para>The first step is to create /etc/hosts. This file contains
+<para>The first step is to create <filename>/etc/hosts</filename>. This file
-information allowing resolution of hostnames to IP addresses. Create a
+contains information allowing resolution of host names to IP addresses.
-very basic one (we'll make a better one later) with the following
+Create a very basic one (we'll make a better one later) with the following
 command:</para>
 
 <para><screen><userinput>echo "127.0.0.1 $(hostname) localhost" > /etc/hosts</userinput></screen></para>
 
 <para>Now unpack the Lfs-Utils tarball again, as we're going to copy two
-necessary files from it. One is the /etc/services file, which is used to
+necessary files from it. One is <filename>/etc/services</filename>, which is
-resolv service numbers to human-readable names, and the /etc/protocols
+used to resolve service numbers to human-readable names, and the other is
-file, which does the same for protocol numbers. Copy them with the
+<filename>/etc/protocols</filename>, which does the same for protocol numbers.
-following command after you have entered the Lfs-Utils directory:</para>
+Copy them with the following command after you have entered the Lfs-Utils
+directory:</para>
 
 <para><screen><userinput>cp -f etc/{services,protocols} /etc</userinput></screen></para>