Add clarifying notes for Chapter 5 test suites of Tcl, Expect and Gettext.

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

chapter01/conventions.xml

@@ -39,7 +39,7 @@ bin:x:1:
 </screen>
 
 <blockquote><para>This type of section is used mainly when creating 
-configuration files. The first command (in bold) tells the system to create 
+configuration files. The first command tells the system to create 
 the file $LFS/etc/group from whatever is typed on the following lines until 
 the sequence EOF is encountered. Therefore, this whole section is generally 
 typed as seen.</para></blockquote>

chapter05/expect-inst.xml

@@ -32,8 +32,11 @@ libraries, both of which may possibly reside on the host system.</para></listite
 <screen><userinput>make</userinput></screen>
 
 <para>This package has a test suite available which can perform a number of
-checks to ensure it built correctly.  Should you choose to run it, the 
-following command will do so:</para>
+checks to ensure it built correctly. However, the Expect test suite here in
+Chapter 5 is known to experience failures under certain host conditions that
+are not fully understood. Therefore, test suite failures here are not
+surprising, but are not considered critical. Should you choose to run the test
+suite, the following command will do so:</para>
 
 <screen><userinput>make test</userinput></screen>
 

chapter05/gettext-inst.xml

@@ -13,10 +13,11 @@
 
 <para>This package has a test suite available which can perform a number of
 checks to ensure it built correctly. However, the Gettext test suite here in
-Chapter 5 is known to cause problems if for instance it finds a Java compiler
-on the host. It also takes a very long time to run and is considered not
-critical to the success of the overall build. We therefore recommend not to run
-it here. Should you choose to run it, the following command will do so:</para>
+Chapter 5 is known to experience failures under certain host conditions -- for
+example, if it finds a Java compiler on the host. The Gettext test suite takes
+a very long time to run and is not considered critical. Therefore, we don't
+recommend running it here. Should you choose to run it, the following command
+will do so:</para>
 
 <screen><userinput>make check</userinput></screen>
 

chapter05/tcl-inst.xml

@@ -17,9 +17,12 @@ to know that our most important tools are working properly.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of 
-checks to ensure it built correctly.  Should you choose to run it, the 
-following command will do so:</para>
+<para>This package has a test suite available which can perform a number of
+checks to ensure it built correctly. However, the Tcl test suite here in
+Chapter 5 is known to experience failures under certain host conditions that
+are not fully understood. Therefore, test suite failures here are not
+surprising, but are not considered critical. Should you choose to run the test
+suite, the following command will do so:</para>
 
 <screen><userinput>TZ=UTC make test</userinput></screen>