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

3 files changed, 16 insertions, 9 deletions

diff --git a/chapter05/expect-inst.xml b/chapter05/expect-inst.xml
index 6c861558b..2f6387ef9 100644
--- a/chapter05/expect-inst.xml
+++ b/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>
 
diff --git a/chapter05/gettext-inst.xml b/chapter05/gettext-inst.xml
index 75919481b..0d6c1f9da 100644
--- a/chapter05/gettext-inst.xml
+++ b/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>
 
diff --git a/chapter05/tcl-inst.xml b/chapter05/tcl-inst.xml
index 5d93829ee..b20a2c173 100644
--- a/chapter05/tcl-inst.xml
+++ b/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>