Making the chapter 6 tests more obviously optional.

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

chapter06/autoconf.xml

@@ -23,15 +23,9 @@ can automatically configure source code.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which performs a number of
+<para>To have the results tested, issue:
-checks to ensure it will function correctly. It's worth noting that Autoconf
+<userinput>make check</userinput>.This takes a long time, about 2 SBUs,
-does not play a critical role in the overall operation of an LFS system. In
+and is strictly optional.</para>
-addition, the Autoconf test suite runs for quite a long period of time.
-Accordingly, the running of the test suite here is not crucial. Should you
-choose to run the Autoconf test suite, the following command will do
-so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/automake.xml

@@ -24,15 +24,9 @@ with Autoconf.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which performs a number of 
+<para>To have the results tested, issue:
-checks to ensure it will function correctly. It's worth noting that Automake
+<userinput>make check</userinput>. This takes a long time, about 4 SBUs,
-does not play a critical role in the overall operation of an LFS system. In 
+and is strictly optional.</para>
-addition, the Automake test suite runs for quite a long period of time. 
-Accordingly, the running of the test suite here is not crucial. Should you 
-choose to run the Automake test suite, the following command will do 
-so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>Install the package:</para>
 

chapter06/bash.xml

@@ -29,11 +29,8 @@ patch:</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make tests</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make tests</userinput></screen>
 
 <para>Install the package:</para>
 

chapter06/bison.xml

@@ -28,11 +28,8 @@ the patch is backported from CVS:</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so (and takes a long time):</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/coreutils.xml

@@ -41,14 +41,13 @@ provided by Net-tools. Prevent its installation by applying a patch:</para>
 <screen><userinput>make</userinput></screen>
 
 <para>The <command>su</command> program from Coreutils wasn't installed in
-Chapter 5 because it needed <emphasis>root</emphasis> privilege to do so. We're
+<xref linkend="chapter-temporary-tools"/> because it needed
-going to need it in a few moments for the test suite. Therefore we work around
+<emphasis>root</emphasis> privilege to do so. We're going to need it in a few
-the problem by installing it now:</para>
+moments for the test suite. Therefore we install it now:</para>
 
 <screen><userinput>make install-root</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>The test suite of this package
-checks to ensure it built correctly. However, this particular test suite
 makes some assumptions with regards to the presence of non-root users and
 groups that don't apply this early into the LFS build. We therefore create
 a dummy system user and two dummy groups to allow the tests to run

chapter06/e2fsprogs.xml

@@ -49,11 +49,8 @@ of.</para></listitem>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>Install most of the package:</para>
 

chapter06/ed.xml

@@ -48,11 +48,8 @@ the programs available there is useful in the event of the
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>Install the package:</para>
 

chapter06/findutils.xml

@@ -30,11 +30,8 @@ to the above configure options.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/flex.xml

@@ -24,11 +24,8 @@ recognize patterns in text.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make bigcheck</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make bigcheck</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/gawk.xml

@@ -23,11 +23,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/gettext.xml

@@ -25,15 +25,9 @@ localization. These allow programs to be compiled with Native Language Support
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which performs a number of
+<para>To have the results tested, issue:
-checks to ensure it will function correctly. It's worth noting that Gettext
+<userinput>make check</userinput>. This takes a very long time, around
-does not play a critical role in the overall operation of an LFS system. In
+6 SBUs.</para>
-addition, the Gettext test suite runs for quite a long period of time.
-Accordingly, the running of the test suite here is not crucial. Should you
-choose to run the Gettext test suite, the following command will do
-so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/grep.xml

@@ -23,11 +23,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/libtool.xml

@@ -25,11 +25,8 @@ interface.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/m4.xml

@@ -23,11 +23,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/make.xml

@@ -23,11 +23,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/perl.xml

@@ -36,10 +36,9 @@ program.</para></listitem>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>If you wish to run the test suite, you first have to create a basic
-checks to ensure it built correctly.  Should you choose to run it, you first
+<filename>/etc/hosts</filename> file, which is needed by a couple of tests to
-have to create a basic <filename>/etc/hosts</filename> file, needed by a
+resolve the name <emphasis>localhost</emphasis>:</para>
-couple of tests to resolve the name <emphasis>localhost</emphasis>:</para>
 
 <screen><userinput>echo "127.0.0.1 localhost $(hostname)" &gt; /etc/hosts</userinput></screen>
 

chapter06/sed.xml

@@ -23,11 +23,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/tar.xml

@@ -24,11 +24,8 @@
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/texinfo.xml

@@ -24,11 +24,8 @@ converting Info documents.</para>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly.  Should you choose to run it, the 
+<userinput>make check</userinput>.</para>
-following command will do so:</para>
-
-<screen><userinput>make check</userinput></screen>
 
 <para>Install the package:</para>
 

chapter06/vim.xml

@@ -39,14 +39,11 @@ echo '#define SYS_GVIMRC_FILE "/etc/gvimrc"' &gt;&gt; src/feature.h</userinput><
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which performs a number of
+<para>To have the results tested, you can issue:
-checks to ensure it will function correctly. However, the Vim test suite will
+<userinput>make check</userinput>. However, this test suite outputs a lot of
-output a whole lot of seemingly garbage characters to screen which can
+seemingly garbage characters to the screen, and this can wreak havoc with the
-occasionally wreak havoc with the running terminal. Accordingly, the running of
+settings of the current terminal. Accordingly, the running of the test suite
-the test suite here is optional. Should you choose to run the Vim test suite,
+here is strictly optional.</para>
-the following command will do so:</para>
-
-<screen><userinput>make test</userinput></screen>
 
 <para>And install the package:</para>
 

chapter06/zlib.xml

@@ -30,10 +30,8 @@ afterwards.</para></note>
 
 <screen><userinput>make</userinput></screen>
 
-<para>This package has a test suite available which can perform a number of
+<para>To have the results tested, issue:
-checks to ensure it built correctly. The test suite for Zlib is quick and
+<userinput>make check</userinput>.</para>
-painless so we recommend it be run. The following command will test the shared
-library:</para>
 
 <screen><userinput>make check</userinput></screen>
 
@@ -46,9 +44,8 @@ library:</para>
 ./configure --prefix=/usr
 make</userinput></screen>
 
-<para>The following command will test the static library:</para>
+<para>To have the results tested, issue:
-
+<userinput>make check</userinput>.</para>
-<screen><userinput>make check</userinput></screen>
 
 <para>Install the static library:</para>