aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGreg Schafer <greg@linuxfromscratch.org>2004-01-16 10:15:49 +0000
committerGreg Schafer <greg@linuxfromscratch.org>2004-01-16 10:15:49 +0000
commit31b2ae676d85a5b1efe3ef3105ef14f9ae6623af (patch)
tree325b52ac2c9754beea3ccdee44bcdba8db7281b8
parent0b438341dc1967bb5b7742a7ed5b49c8bbcae2c9 (diff)
First stage towards Bug 719. Making the Chapter 5 test suites
strictly optional. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3170 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
-rw-r--r--chapter02/abouttestsuites.xml9
-rw-r--r--chapter05/bash.xml6
-rw-r--r--chapter05/coreutils.xml6
-rw-r--r--chapter05/expect.xml12
-rw-r--r--chapter05/findutils.xml6
-rw-r--r--chapter05/gawk.xml6
-rw-r--r--chapter05/gettext.xml16
-rw-r--r--chapter05/grep.xml6
-rw-r--r--chapter05/make.xml6
-rw-r--r--chapter05/sed.xml6
-rw-r--r--chapter05/tar.xml6
-rw-r--r--chapter05/tcl.xml12
-rw-r--r--chapter05/texinfo.xml6
-rw-r--r--index.xml4
14 files changed, 58 insertions, 49 deletions
diff --git a/chapter02/abouttestsuites.xml b/chapter02/abouttestsuites.xml
index 9cf6b3a9e..1403629c3 100644
--- a/chapter02/abouttestsuites.xml
+++ b/chapter02/abouttestsuites.xml
@@ -16,6 +16,15 @@ properly functioning system. But be warned, the test suites for GCC and Glibc
can take a very long period of time to complete, especially on slower
hardware.</para>
+<para>Experience has shown us that there is little to be gained from running
+the test suites in Chapter 5. There can be no escaping the fact that the host
+system always exerts influence on the Chapter 5 tests, often causing weird and
+inexplicable failures. Not only that, the tools built in Chapter 5 are
+temporary and eventually discarded. For the average reader of this book we
+recommend not to run the Chapter 5 test suites. The instructions for running
+the Chapter 5 test suites are still provided for the benefit of testers and
+developers but they are strictly optional for everyone else.</para>
+
<para>As you progress through the book and encounter the build commands to
run the various test suites, we'll guide you on the relative importance of
the test suite in question so that you can decide for yourself whether to
diff --git a/chapter05/bash.xml b/chapter05/bash.xml
index 5129f3088..579e518a1 100644
--- a/chapter05/bash.xml
+++ b/chapter05/bash.xml
@@ -26,9 +26,9 @@ patch:</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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Bash test
+suite anyway, the following command will do so:</para>
<screen><userinput>make tests</userinput></screen>
diff --git a/chapter05/coreutils.xml b/chapter05/coreutils.xml
index 4a494d7a8..31d59312b 100644
--- a/chapter05/coreutils.xml
+++ b/chapter05/coreutils.xml
@@ -23,9 +23,9 @@ Estimated required disk space: &coreutils-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Coreutils
+test suite anyway, the following command will do so:</para>
<screen><userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput></screen>
diff --git a/chapter05/expect.xml b/chapter05/expect.xml
index 003a2a1f7..1fdd78b4f 100644
--- a/chapter05/expect.xml
+++ b/chapter05/expect.xml
@@ -44,12 +44,12 @@ 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. However, the Expect test suite
-is known to experience failures under certain host conditions that
-are not fully understood. Therefore, test suite failures here are not
-surprising, and are not considered critical. Should you choose to run the test
-suite, the following command will do so:</para>
+<para>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Expect test
+suite anyway, the following command will do so. However, you should be aware
+that the Expect test suite is sometimes 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:</para>
<screen><userinput>make test</userinput></screen>
diff --git a/chapter05/findutils.xml b/chapter05/findutils.xml
index 2d4d4db4a..53fd69bc0 100644
--- a/chapter05/findutils.xml
+++ b/chapter05/findutils.xml
@@ -21,9 +21,9 @@ Estimated required disk space: &findutils-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Findutils
+test suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/gawk.xml b/chapter05/gawk.xml
index f5f7f6560..02c614071 100644
--- a/chapter05/gawk.xml
+++ b/chapter05/gawk.xml
@@ -23,9 +23,9 @@ Estimated required disk space: &gawk-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Gawk test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/gettext.xml b/chapter05/gettext.xml
index ae32f4166..726e1d6e4 100644
--- a/chapter05/gettext.xml
+++ b/chapter05/gettext.xml
@@ -21,14 +21,14 @@ Estimated required disk space: &gettext-compsize-tools;</screen>
<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. However, the Gettext test suite is known
-to experience failures under certain host conditions -- for
-example, if it finds a Java compiler on the host (Note: an experimental patch
-to disable Java is available from the patches project). 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>
+<para>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Gettext test
+suite anyway, the following command will do so. However, you should be aware
+that the Gettext test suite is known to experience failures under certain host
+conditions -- for example, when it finds a Java compiler on the host (Note: an
+experimental patch to disable Java is available from the patches project). Not
+only that, the Gettext test suite takes an excessive amount of time to run and
+is not considered critical:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/grep.xml b/chapter05/grep.xml
index b06a4e265..931d09671 100644
--- a/chapter05/grep.xml
+++ b/chapter05/grep.xml
@@ -34,9 +34,9 @@ the code from Glibc, which is known to be slightly buggy.</para></listitem>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Grep test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/make.xml b/chapter05/make.xml
index b6ae78fed..a330b02fa 100644
--- a/chapter05/make.xml
+++ b/chapter05/make.xml
@@ -21,9 +21,9 @@ Estimated required disk space: &make-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Make test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/sed.xml b/chapter05/sed.xml
index 791f3b713..297f788b9 100644
--- a/chapter05/sed.xml
+++ b/chapter05/sed.xml
@@ -21,9 +21,9 @@ Estimated required disk space: &sed-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Sed test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/tar.xml b/chapter05/tar.xml
index 40bed66ef..422da02ad 100644
--- a/chapter05/tar.xml
+++ b/chapter05/tar.xml
@@ -21,9 +21,9 @@ Estimated required disk space: &tar-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Tar test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml
index ed5ecef61..68336d979 100644
--- a/chapter05/tcl.xml
+++ b/chapter05/tcl.xml
@@ -29,12 +29,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. However, the Tcl test suite in this
-chapter 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>
+<para>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Tcl test
+suite anyway, the following command will do so. However, you should be aware
+that the Tcl test suite is sometimes 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:</para>
<screen><userinput>TZ=UTC make test</userinput></screen>
diff --git a/chapter05/texinfo.xml b/chapter05/texinfo.xml
index c8a697e24..14bbcfba2 100644
--- a/chapter05/texinfo.xml
+++ b/chapter05/texinfo.xml
@@ -21,9 +21,9 @@ Estimated required disk space: &texinfo-compsize-tools;</screen>
<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>As discussed earlier, we don't recommend running the test suites for the
+temporary tools here in this chapter. If you still want to run the Texinfo test
+suite anyway, the following command will do so:</para>
<screen><userinput>make check</userinput></screen>
diff --git a/index.xml b/index.xml
index 3ceb86140..ee27caa8c 100644
--- a/index.xml
+++ b/index.xml
@@ -2,8 +2,8 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"/usr/share/docbook/docbookx.dtd" [
-<!ENTITY version "CVS-2004-01-14">
-<!ENTITY releasedate "January 14th, 2004">
+<!ENTITY version "CVS-2004-01-16">
+<!ENTITY releasedate "January 16th, 2004">
<!ENTITY milestone "5.1">
<!ENTITY nbsp " ">