diff options
35 files changed, 144 insertions, 49 deletions
diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml index 0cae7132d..a1cea4f90 100644 --- a/chapter01/changelog.xml +++ b/chapter01/changelog.xml @@ -83,6 +83,9 @@ </itemizedlist> </para></listitem> +<listitem><para>September 11th, 2003 [jeremy]: Dropped non-toolchain tests +to optional actions. Added a note to use the wiki for failed tests.</para></listitem> + <listitem><para>September 11th, 2003 [jeremy]: Added Bison patch, backported from CVS, to fix pwlib compilation problems</para></listitem> diff --git a/chapter02/askforhelp.xml b/chapter02/askforhelp.xml index 645b6ac37..1e980cec1 100644 --- a/chapter02/askforhelp.xml +++ b/chapter02/askforhelp.xml @@ -87,5 +87,16 @@ need.</para> </sect2> +<sect2> +<title>Testsuite problems</title> + +<para>Many of the testsuite for packages will generate false errors. When +you encounter these, you can check the LFS Wiki page at +<ulink url="http://wiki.linuxfromscratch.org"/> for our results, to see if +our testing also shows the checks to be failing.</para> + +</sect2> + + </sect1> diff --git a/chapter05/bash-inst.xml b/chapter05/bash-inst.xml index eab96f228..b181413e6 100644 --- a/chapter05/bash-inst.xml +++ b/chapter05/bash-inst.xml @@ -16,7 +16,9 @@ patch:</para> <para><screen><userinput>make</userinput></screen></para> -<para>Check that it works correctly:</para> +<para>This package has a testsuite 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><screen><userinput>make tests</userinput></screen></para> diff --git a/chapter05/coreutils-inst.xml b/chapter05/coreutils-inst.xml index 277c045e3..0d3534b93 100644 --- a/chapter05/coreutils-inst.xml +++ b/chapter05/coreutils-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results thoroughly:</para> +<para>This package has a testsuite 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><screen><userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput></screen></para> diff --git a/chapter05/expect-inst.xml b/chapter05/expect-inst.xml index 73fefd214..a0e0ac1f3 100644 --- a/chapter05/expect-inst.xml +++ b/chapter05/expect-inst.xml @@ -14,14 +14,19 @@ GCC test suite run.</para> <para><screen><userinput>./configure --prefix=/tools --with-tcl=/tools/lib --with-x=no</userinput></screen></para> -<para>Build, test, and install the package:</para> +<para>Build the package:</para> -<para><screen><userinput>make -make test -make install</userinput></screen></para> +<para><screen><userinput>make</userinput></screen></para> -<para>Note that also here some of the tests might fail, and that this is not a -problem here either.</para> +<para>This package has a testsuite 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><screen><userinput>make test</userinput></screen></para> + +<para>And install:</para> + +<para><screen><userinput>make install</userinput></screen></para> <para>You can now remove the source directories of both Tcl and Expect.</para> diff --git a/chapter05/findutils-inst.xml b/chapter05/findutils-inst.xml index a43cf15bf..363449bd2 100644 --- a/chapter05/findutils-inst.xml +++ b/chapter05/findutils-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/gettext-inst.xml b/chapter05/gettext-inst.xml index dd93ed683..798393ca9 100644 --- a/chapter05/gettext-inst.xml +++ b/chapter05/gettext-inst.xml @@ -11,8 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Check that the programs work correctly (this takes so long you can go -for a walk):</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/grep-inst.xml b/chapter05/grep-inst.xml index e72404e54..6051ffd2e 100644 --- a/chapter05/grep-inst.xml +++ b/chapter05/grep-inst.xml @@ -12,7 +12,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Check that the programs work correctly:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/make-inst.xml b/chapter05/make-inst.xml index 7f5d2b18e..529f2d3d4 100644 --- a/chapter05/make-inst.xml +++ b/chapter05/make-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Test the program:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/sed-inst.xml b/chapter05/sed-inst.xml index 9a5bf4111..c7bd03ec5 100644 --- a/chapter05/sed-inst.xml +++ b/chapter05/sed-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Test the program:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/tar-inst.xml b/chapter05/tar-inst.xml index be4c2f075..316ad2541 100644 --- a/chapter05/tar-inst.xml +++ b/chapter05/tar-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Check that the programs work correctly:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter05/tcl-inst.xml b/chapter05/tcl-inst.xml index a0be4332d..8589d0ff8 100644 --- a/chapter05/tcl-inst.xml +++ b/chapter05/tcl-inst.xml @@ -13,20 +13,29 @@ essential, to know that our most important tools are working properly.</para> <para><screen><userinput>cd unix ./configure --prefix=/tools</userinput></screen></para> -<para>Build, test, and install the package:</para> +<para>Build, the package:</para> -<para><screen><userinput>make -make -k test -make install</userinput></screen></para> +<para><screen><userinput>make</userinput></screen></para> -<para>Note that several of the tests may fail (for exmple the clock test). -This is, however, not a problem: the program will work well enough to be able -to run the GCC and Binutils test suites.</para> +<para>This package has a testsuite 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><screen><userinput>TZ=UTC make -k test</userinput></screen></para> + +<para>Sometimes, package testsuites 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 +throughout the book.</para> + +<para>Install the package:</para> + +<para><screen><userinput>make install</userinput></screen></para> <para>Make a link:</para> <para><screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen></para> -<caution><para><emphasis>Do not remove</emphasis> the +<caution><para>Do not remove the <filename>tcl&tcl-version;</filename> source directory yet, as the next package will need its internal headers.</para></caution> diff --git a/chapter05/texinfo-inst.xml b/chapter05/texinfo-inst.xml index 6cb7bbb0b..7ce35619a 100644 --- a/chapter05/texinfo-inst.xml +++ b/chapter05/texinfo-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make </userinput></screen></para> -<para>Check that the programs work correctly:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/autoconf-inst.xml b/chapter06/autoconf-inst.xml index de0f8160f..0f33c0ca9 100644 --- a/chapter06/autoconf-inst.xml +++ b/chapter06/autoconf-inst.xml @@ -10,7 +10,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/automake-inst.xml b/chapter06/automake-inst.xml index deb241e12..ebafae19f 100644 --- a/chapter06/automake-inst.xml +++ b/chapter06/automake-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/bash-inst.xml b/chapter06/bash-inst.xml index 003d02f93..4f0647c34 100644 --- a/chapter06/bash-inst.xml +++ b/chapter06/bash-inst.xml @@ -17,7 +17,9 @@ patch:</para> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make tests</userinput></screen></para> diff --git a/chapter06/bison-inst.xml b/chapter06/bison-inst.xml index 3eb085a32..8e745ffcf 100644 --- a/chapter06/bison-inst.xml +++ b/chapter06/bison-inst.xml @@ -16,7 +16,9 @@ compliation problem with some packages:</para> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/coreutils-inst.xml b/chapter06/coreutils-inst.xml index f84b48c43..cebd1839e 100644 --- a/chapter06/coreutils-inst.xml +++ b/chapter06/coreutils-inst.xml @@ -23,7 +23,9 @@ provided by Net-tools. Prevent its installation by applying a patch:</para> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results thoroughly:</para> +<para>This package has a testsuite 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><screen><userinput>make check-root make RUN_EXPENSIVE_TESTS=yes check</userinput></screen></para> diff --git a/chapter06/diffutils-inst.xml b/chapter06/diffutils-inst.xml index 2440cecd4..7fa26aa8f 100644 --- a/chapter06/diffutils-inst.xml +++ b/chapter06/diffutils-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/e2fsprogs-inst.xml b/chapter06/e2fsprogs-inst.xml index bf5e3a154..e2fff07e0 100644 --- a/chapter06/e2fsprogs-inst.xml +++ b/chapter06/e2fsprogs-inst.xml @@ -36,7 +36,9 @@ of.</para></listitem> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/ed-inst.xml b/chapter06/ed-inst.xml index ee6805bf3..f31a7e9ea 100644 --- a/chapter06/ed-inst.xml +++ b/chapter06/ed-inst.xml @@ -27,7 +27,9 @@ create temporary files.</para> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/findutils-inst.xml b/chapter06/findutils-inst.xml index a43fc1dad..e4f2da960 100644 --- a/chapter06/findutils-inst.xml +++ b/chapter06/findutils-inst.xml @@ -17,7 +17,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/flex-inst.xml b/chapter06/flex-inst.xml index 6e908ad35..50a2cbb2d 100644 --- a/chapter06/flex-inst.xml +++ b/chapter06/flex-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make bigcheck</userinput></screen></para> diff --git a/chapter06/gawk-inst.xml b/chapter06/gawk-inst.xml index b96c42e87..f989517fb 100644 --- a/chapter06/gawk-inst.xml +++ b/chapter06/gawk-inst.xml @@ -41,7 +41,9 @@ with its contents on a make uninstall.</para></listitem> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/gettext-inst.xml b/chapter06/gettext-inst.xml index c35ff0f5b..05866cabf 100644 --- a/chapter06/gettext-inst.xml +++ b/chapter06/gettext-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/grep-inst.xml b/chapter06/grep-inst.xml index 4345f7a49..2695de465 100644 --- a/chapter06/grep-inst.xml +++ b/chapter06/grep-inst.xml @@ -12,7 +12,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/libtool-inst.xml b/chapter06/libtool-inst.xml index 9e8456264..541adf737 100644 --- a/chapter06/libtool-inst.xml +++ b/chapter06/libtool-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/m4-inst.xml b/chapter06/m4-inst.xml index af4cf6908..8f98c87df 100644 --- a/chapter06/m4-inst.xml +++ b/chapter06/m4-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/make-inst.xml b/chapter06/make-inst.xml index 2b8248d1e..1ca97b9ce 100644 --- a/chapter06/make-inst.xml +++ b/chapter06/make-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/patch-inst.xml b/chapter06/patch-inst.xml index eb3635605..8ef395093 100644 --- a/chapter06/patch-inst.xml +++ b/chapter06/patch-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/perl-inst.xml b/chapter06/perl-inst.xml index 5d90fdc99..f0860cb2e 100644 --- a/chapter06/perl-inst.xml +++ b/chapter06/perl-inst.xml @@ -17,7 +17,9 @@ above.</para> <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make test</userinput></screen></para> diff --git a/chapter06/sed-inst.xml b/chapter06/sed-inst.xml index 4784ed4cc..e43ce3702 100644 --- a/chapter06/sed-inst.xml +++ b/chapter06/sed-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/tar-inst.xml b/chapter06/tar-inst.xml index aa9112405..d7bba9334 100644 --- a/chapter06/tar-inst.xml +++ b/chapter06/tar-inst.xml @@ -12,7 +12,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/texinfo-inst.xml b/chapter06/texinfo-inst.xml index 4dc11144f..8db6ee4ee 100644 --- a/chapter06/texinfo-inst.xml +++ b/chapter06/texinfo-inst.xml @@ -11,7 +11,9 @@ <para><screen><userinput>make</userinput></screen></para> -<para>Test the results:</para> +<para>This package has a testsuite 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><screen><userinput>make check</userinput></screen></para> diff --git a/chapter06/zlib-inst.xml b/chapter06/zlib-inst.xml index b00d14499..e48f454e5 100644 --- a/chapter06/zlib-inst.xml +++ b/chapter06/zlib-inst.xml @@ -26,12 +26,20 @@ directive during this stage, and remove it after.</para> <para><screen><userinput>make install</userinput></screen></para> -<para>Now also build and install the non-shared libraries:</para> +<para>Now also build the non-shared libraries:</para> <para><screen><userinput>make clean ./configure --prefix=/usr -make -make test -make install</userinput></screen></para> +make</userinput></screen></para> + +<para>This package has a testsuite 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><screen><userinput>make test</userinput></screen></para> + +<para>And install the package:</para> + +<para><screen><userinput>make install</userinput></screen></para> <para>The shared Zlib library should be installed in the <filename>/lib</filename> directory. That way, in the event |