diff --git a/appendixa/expect-shortdesc.xml b/appendixa/expect-shortdesc.xml index 7710293c4..8915cf2ca 100644 --- a/appendixa/expect-shortdesc.xml +++ b/appendixa/expect-shortdesc.xml @@ -4,7 +4,7 @@ Installed program: expect -Installed library: libexpect5.39.a +Installed library: libexpect&expect-version;.a diff --git a/chapter02/abouttestsuites.xml b/chapter02/abouttestsuites.xml index e580a9a79..ccf6c8099 100644 --- a/chapter02/abouttestsuites.xml +++ b/chapter02/abouttestsuites.xml @@ -5,37 +5,36 @@ Most packages provide a test suite. Running the test suite for a newly built package is generally a good idea, as it can provide a nice sanity check that everything compiled correctly. A test suite that passes its set of checks -usually proves that the package is functioning mostly as the developer -intended. It does not, however, guarantee that the package is totally bug -free. +usually proves that the package is functioning as the developer intended. It +does not, however, guarantee that the package is totally bug free. Some test suites are more important than others. For example, the test -suites for the core toolchain packages -- GCC, Binutils, and Glibc (the C -library) -- are of the utmost importance due to their central role in a -properly functioning system. But be warned, the test suites for GCC and Glibc -can take a very long time to complete, especially on slower hardware. +suites for the core toolchain packages -- GCC, Binutils, and Glibc -- are of +the utmost importance due to their central role in a properly functioning +system. But be warned, the test suites for GCC and Glibc can take a very long +time to complete, especially on slower hardware. -Experience has shown us that there is little to be gained from running -the test suites in . There can be no escaping the -fact that the host system always exerts influence on the tests in that chapter, -often causing weird and inexplicable failures. Not only that, the tools built -in are temporary and eventually discarded. For the -average reader of this book we recommend not to run the -test suites in . The instructions for running those -test suites are still provided for the benefit of testers and developers, but -they are strictly optional for everyone else. +Experience has shown us that there is little to be gained from running +the test suites in . There can be no +escaping the fact that the host system always exerts some influence on the +tests in that chapter, often causing weird and inexplicable failures. Not only +that, the tools built in are +temporary and eventually discarded. For the average reader of this book we +recommend not to run the test suites in . The instructions for running those test +suites are still provided for the benefit of testers and developers, but they +are strictly optional for everyone else. -As you progress through the book and encounter the 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 run that one -or not. - -A common problem when running the test suites for Binutils and GCC -is running out of pseudo terminals (PTYs for short). The symptom is an -unusually high number of failing tests. This can happen for a number of -reasons. Most likely is that the host system doesn't have the +A common problem when running the test suites for Binutils and GCC is +running out of pseudo terminals (PTYs for short). The symptom is a very high +number of failing tests. This can happen for several reasons, but the most +likely cause is that the host system doesn't have the devpts file system set up correctly. We'll discuss this in -more detail later on in . +more detail 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. diff --git a/chapter04/chapter04.xml b/chapter04/chapter04.xml index 038038944..d050c8bcf 100644 --- a/chapter04/chapter04.xml +++ b/chapter04/chapter04.xml @@ -167,7 +167,7 @@ M4 (&m4-version;) - &m4-size;: Make (&make-version;) - &make-size;: - + Make_devices (&makedev-version;) - &makedev-size;: 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: