From c91dd5bfd04b3188fd81bfe9c93d4a6985fdc0d5 Mon Sep 17 00:00:00 2001 From: Alex Gronenwoud Date: Wed, 11 Feb 2004 22:02:10 +0000 Subject: Making the test suites in chapter 5 more clearly optional. git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3248 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter05/bash.xml | 7 ++----- chapter05/coreutils.xml | 36 ++++++++++++++---------------------- chapter05/expect.xml | 15 ++++++--------- chapter05/findutils.xml | 7 ++----- chapter05/gawk.xml | 7 ++----- chapter05/gettext.xml | 16 ++++++---------- chapter05/grep.xml | 7 ++----- chapter05/kernelheaders.xml | 2 +- chapter05/make.xml | 7 ++----- chapter05/patch.xml | 7 +++---- chapter05/sed.xml | 7 ++----- chapter05/tar.xml | 7 ++----- chapter05/tcl.xml | 33 ++++++++++----------------------- chapter05/texinfo.xml | 7 ++----- 14 files changed, 56 insertions(+), 109 deletions(-) (limited to 'chapter05') diff --git a/chapter05/bash.xml b/chapter05/bash.xml index 05e62ab97..45e12e64e 100644 --- a/chapter05/bash.xml +++ b/chapter05/bash.xml @@ -26,11 +26,8 @@ patch: make -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: - -make tests +(If you insist on testing the results, then issue: +make tests.) Then install it and its documentation: diff --git a/chapter05/coreutils.xml b/chapter05/coreutils.xml index cea1f6fd6..6672e18d5 100644 --- a/chapter05/coreutils.xml +++ b/chapter05/coreutils.xml @@ -18,14 +18,15 @@ And for the patch: Installation of Coreutils Coreutils has an issue when compiled against Glibc-&glibc-version;. -Without the patch below, some of the Coreutils utilities (head, tail, sort etc) -will reject their traditional syntax which has been in use for approximately 30 -years. The old syntax is so pervasive that compatibility must be preserved until -the many places where it is used can be updated. More details are provided in -the comments inside the patch itself. Use of this patch is by no means -compulsory but opting not to use it means you'll have deal with the consequences -yourself, i.e. patch the many software packages that use the old syntax. Apply -the patch: +Without the patch below, some of the Coreutils utilities +(head, tail, sort, +and others) will reject their traditional syntax which has been in use for +approximately 30 years. This old syntax is so pervasive that compatibility +should be preserved until the many places where it is used can be updated. +More details on this are provided in the comments inside the patch itself. Use +of this patch is by no means compulsory, but not using it means you'll have to +deal with the consequences yourself: patch the many packages that use the old +syntax. Therefore, better apply the patch: patch -Np1 -i ../&coreutils-posixver-patch; @@ -37,20 +38,11 @@ the patch: make -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: - -make RUN_EXPENSIVE_TESTS=yes check - -The meaning of the make parameter: - - -RUN_EXPENSIVE_TESTS=yes: This tells the -test suite to run several additional tests that are considered relatively -expensive on some platforms. However, they are generally not a problem on -Linux. - +(If you insist on testing the results, then issue: +make RUN_EXPENSIVE_TESTS=yes check. The +RUN_EXPENSIVE_TESTS=yes parameter tells the test suite to +run several additional tests that are considered relatively expensive on some +platforms but generally are not a problem on Linux.) And install the package: diff --git a/chapter05/expect.xml b/chapter05/expect.xml index 3720ecbcc..5cdcba409 100644 --- a/chapter05/expect.xml +++ b/chapter05/expect.xml @@ -44,16 +44,13 @@ libraries, both of which may possibly reside on the host system.make -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: +(If you insist on testing the results, then issue: +make test. 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.) -make test - -And install: +And install it: make SCRIPTS="" install diff --git a/chapter05/findutils.xml b/chapter05/findutils.xml index f31929aea..8d76082e7 100644 --- a/chapter05/findutils.xml +++ b/chapter05/findutils.xml @@ -21,11 +21,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) And install the package: diff --git a/chapter05/gawk.xml b/chapter05/gawk.xml index 7bf1d1314..62c84523b 100644 --- a/chapter05/gawk.xml +++ b/chapter05/gawk.xml @@ -23,11 +23,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) And install it: diff --git a/chapter05/gettext.xml b/chapter05/gettext.xml index a8eda134e..9e3ca36aa 100644 --- a/chapter05/gettext.xml +++ b/chapter05/gettext.xml @@ -21,16 +21,12 @@ make -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: - -make check +(If you insist on testing the results, then issue: make +check. This takes a very long time, around 6 SBUs. Moreover, the +Gettext test suite is known to experience failures under certain host +conditions -- for example when it finds a Java compiler on the host (but an +experimental patch to disable Java is available from the LFS Patches +project).) And install the package: diff --git a/chapter05/grep.xml b/chapter05/grep.xml index e05a15341..c40e7ed84 100644 --- a/chapter05/grep.xml +++ b/chapter05/grep.xml @@ -34,11 +34,8 @@ use the code from Glibc, which is known to be slightly buggy. make -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: - -make check +(If you insist on testing the results, then issue: +make check.) Then install them and their documentation: diff --git a/chapter05/kernelheaders.xml b/chapter05/kernelheaders.xml index 67636e622..ba3b2720a 100644 --- a/chapter05/kernelheaders.xml +++ b/chapter05/kernelheaders.xml @@ -38,7 +38,7 @@ symlink: cp include/asm/* /tools/include/asm cp -R include/asm-generic /tools/include -Install the cross-platform kernel header files: +And finally install the cross-platform kernel header files: cp -R include/linux /tools/include diff --git a/chapter05/make.xml b/chapter05/make.xml index d182385a6..fb34e27b1 100644 --- a/chapter05/make.xml +++ b/chapter05/make.xml @@ -21,11 +21,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) Then install it and its documentation: diff --git a/chapter05/patch.xml b/chapter05/patch.xml index ab72274aa..d927b0327 100644 --- a/chapter05/patch.xml +++ b/chapter05/patch.xml @@ -13,13 +13,12 @@ Installation of Patch -Prepare Patch for compilation: +Prepare Patch for compilation (the preprocessor flag +-D_GNU_SOURCE is only needed on the PowerPC platform, on +other architectures you can leave it out): CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/tools -The preprocessor flag -D_GNU_SOURCE is only needed -on the PowerPC platform. On other architectures you can leave it out. - Compile the program: make diff --git a/chapter05/sed.xml b/chapter05/sed.xml index 1d6b81870..0102760da 100644 --- a/chapter05/sed.xml +++ b/chapter05/sed.xml @@ -21,11 +21,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) Then install it and its documentation: diff --git a/chapter05/tar.xml b/chapter05/tar.xml index 54404d197..384a73d06 100644 --- a/chapter05/tar.xml +++ b/chapter05/tar.xml @@ -21,11 +21,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) Then install them and their documentation: diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml index 1668a895d..4d51cb53c 100644 --- a/chapter05/tcl.xml +++ b/chapter05/tcl.xml @@ -32,28 +32,15 @@ chapter. make -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: - -TZ=UTC make test - -The meaning of the make parameter: - - -TZ=UTC: This sets the time zone to -Coordinated Universal Time (UTC) also known as Greenwich Mean Time (GMT), but -only for the duration of the test suite run. This ensures the clock tests are -exercised correctly. More information on the TZ environment variable will be -given later on in . - - -Sometimes package test suites will give false failures. You can -consult the LFS Wiki at to verify that these -failures are normal. This applies to all tests throughout the book. +(If you insist on testing the results, then issue: +TZ=UTC make test. However, the Tcl 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. The TZ=UTC parameter sets the time +zone to Coordinated Universal Time (UTC) also known as Greenwich Mean Time +(GMT), but only for the duration of the test suite run. This ensures the clock +tests are exercised correctly. More information on the TZ environment variable +will be given later on in .) Install the package: @@ -69,7 +56,7 @@ will need its internal headers. -Make a necessary symbolic link: +And make a necessary symbolic link: ln -s tclsh8.4 /tools/bin/tclsh diff --git a/chapter05/texinfo.xml b/chapter05/texinfo.xml index fad95fb7f..eee6e2a55 100644 --- a/chapter05/texinfo.xml +++ b/chapter05/texinfo.xml @@ -21,11 +21,8 @@ make -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: - -make check +(If you insist on testing the results, then issue: +make check.) Then install them and their documentation: -- cgit v1.2.3-54-g00ecf