Next batch of fixes for Bug 675 - missing command descriptions.

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

6 files changed, 48 insertions, 6 deletions

diff --git a/chapter05/bash-inst.xml b/chapter05/bash-inst.xml
index 1c047cf2d..89950f847 100644
--- a/chapter05/bash-inst.xml
+++ b/chapter05/bash-inst.xml
@@ -10,7 +10,7 @@ patch:</para>
 
 <para>Now prepare Bash for compilation:</para>
 
-<para><screen><userinput>./configure --prefix=/tools --with-curses</userinput></screen></para>
+<para><screen><userinput>./configure --prefix=/tools</userinput></screen></para>
 
 <para>Compile the program:</para>
 
diff --git a/chapter05/binutils-pass1-inst.xml b/chapter05/binutils-pass1-inst.xml
index e10415645..8b9328755 100644
--- a/chapter05/binutils-pass1-inst.xml
+++ b/chapter05/binutils-pass1-inst.xml
@@ -35,6 +35,7 @@ cd ../binutils-build</userinput></screen></para>
 <listitem><para><userinput>--prefix=/tools</userinput>: This tells the
 configure script to prepare to install the Binutils programs in the
 <filename>/tools</filename> directory.</para></listitem>
+
 <listitem><para><userinput>--disable-nls</userinput>: This disables
 internationalization (a word often shortened to i18n). We don't need this
 for our static programs and <emphasis>nls</emphasis> often causes problems
@@ -69,14 +70,15 @@ make -C ld LIB_PATH=/tools/lib</userinput></screen></para>
 
 <itemizedlist>
 <listitem><para><userinput>-C ld clean</userinput>: This tells the make program
-to remove all the compiled files only in the <filename>ld</filename>
+to remove all the compiled files, but only in the <filename>ld</filename>
 subdirectory.</para></listitem>
 
 <listitem><para><userinput>-C ld LIB_PATH=/tools/lib</userinput>: This option
 rebuilds everything in the <filename>ld</filename> subdirectory. Specifying the
 LIB_PATH makefile variable on the command line allows us to override the default
-value and have it point to our temporary tools location. This preparation will
-be utilised later on in the chapter.</para></listitem>
+value and have it point to our temporary tools location. The value of this
+variable specifies the linker's default library search path. You'll see how this
+preparation is utilised later on in the chapter.</para></listitem>
 </itemizedlist>
 
 <caution><para>Do not yet remove the Binutils build and source
diff --git a/chapter05/binutils-pass2-inst.xml b/chapter05/binutils-pass2-inst.xml
index 6184fc1ac..0f465ba12 100644
--- a/chapter05/binutils-pass2-inst.xml
+++ b/chapter05/binutils-pass2-inst.xml
@@ -17,6 +17,15 @@ cd ../binutils-build</userinput></screen></para>
 <para><screen><userinput>../binutils-&binutils-version;/configure --prefix=/tools \
 &nbsp;&nbsp;&nbsp;&nbsp;--enable-shared --with-lib-path=/tools/lib</userinput></screen></para>
 
+<para>The meaning of the new configure option:</para>
+
+<itemizedlist>
+<listitem><para><userinput>--with-lib-path=/tools/lib</userinput>: This tells
+the configure script to specify the default library search path. We don't want
+the library search path to contain library directories from the host
+system.</para></listitem>
+</itemizedlist>
+
 <para>Before starting to build Binutils, remember to unset any environment
 variables that override the default optimization flags.</para>
 
diff --git a/chapter05/coreutils-inst.xml b/chapter05/coreutils-inst.xml
index 04293d56a..cf0265501 100644
--- a/chapter05/coreutils-inst.xml
+++ b/chapter05/coreutils-inst.xml
@@ -17,10 +17,18 @@ following command will do so:</para>
 
 <para><screen><userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput></screen></para>
 
+<para>The meaning of the make option:</para>
+
+<itemizedlist>
+<listitem><para><userinput>RUN_EXPENSIVE_TESTS=yes</userinput>: This tells the
+test suite to run several additional tests that are considered relatively
+expensive on some platforms. Hovever, they are generally not a problem on
+Linux.</para></listitem>
+</itemizedlist>
+
 <para>And install the package:</para>
 
 <para><screen><userinput>make install</userinput></screen></para>
 
-
 </sect2>
 
diff --git a/chapter05/expect-inst.xml b/chapter05/expect-inst.xml
index 2851ece04..f95e396f1 100644
--- a/chapter05/expect-inst.xml
+++ b/chapter05/expect-inst.xml
@@ -14,6 +14,19 @@ GCC test suite run.</para>
 
 <para><screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib --with-x=no</userinput></screen></para>
 
+<para>The meaning of the configure options:</para>
+
+<itemizedlist>
+<listitem><para><userinput>--with-tcl=/tools/lib</userinput>: This ensures that
+the configure script finds the Tcl installation in our temporary tools location.
+We don't want it to find an existing one that may possibly reside on the host
+system.</para></listitem>
+
+<listitem><para><userinput>--with-x=no</userinput>: This tells the configure
+script not to search for Tk (the Tcl GUI component) or the X Window System
+libraries, both of which may possibly reside on the host system.</para></listitem>
+</itemizedlist>
+
 <para>Build the package:</para>
 
 <para><screen><userinput>make</userinput></screen></para>
diff --git a/chapter05/tcl-inst.xml b/chapter05/tcl-inst.xml
index db8bf811d..cb59f3e86 100644
--- a/chapter05/tcl-inst.xml
+++ b/chapter05/tcl-inst.xml
@@ -23,6 +23,16 @@ following command will do so:</para>
 
 <para><screen><userinput>TZ=UTC make test</userinput></screen></para>
 
+<para>The meaning of the make option:</para>
+
+<itemizedlist>
+<listitem><para><userinput>TZ=UTC</userinput>: This sets the time zone to
+Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT), but
+only for the duration of the test suite run. This ensures the clock tests are
+exercised correctly. More information on the TZ environment variable is
+available later on in Chapter 7.</para></listitem>
+</itemizedlist>
+
 <para>Sometimes, package test suites will give false failures.  You can
 consult the LFS Wiki at <ulink url="http://wiki.linuxfromscratch.org"/>
 to verify that these failures are normal.  This applies to all tests
@@ -32,7 +42,7 @@ throughout the book.</para>
 
 <para><screen><userinput>make install</userinput></screen></para>
 
-<para>Make a link:</para>
+<para>Make a necessary symbolic link:</para>
 <para><screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen></para>
 
 <caution><para>Do not remove the