diff options
Diffstat (limited to 'chapter05')
| -rw-r--r-- | chapter05/bash.xml | 7 | ||||
| -rw-r--r-- | chapter05/coreutils.xml | 36 | ||||
| -rw-r--r-- | chapter05/expect.xml | 15 | ||||
| -rw-r--r-- | chapter05/findutils.xml | 7 | ||||
| -rw-r--r-- | chapter05/gawk.xml | 7 | ||||
| -rw-r--r-- | chapter05/gettext.xml | 16 | ||||
| -rw-r--r-- | chapter05/grep.xml | 7 | ||||
| -rw-r--r-- | chapter05/kernelheaders.xml | 2 | ||||
| -rw-r--r-- | chapter05/make.xml | 7 | ||||
| -rw-r--r-- | chapter05/patch.xml | 7 | ||||
| -rw-r--r-- | chapter05/sed.xml | 7 | ||||
| -rw-r--r-- | chapter05/tar.xml | 7 | ||||
| -rw-r--r-- | chapter05/tcl.xml | 33 | ||||
| -rw-r--r-- | chapter05/texinfo.xml | 7 |
14 files changed, 56 insertions, 109 deletions
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:</para> <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make tests</userinput>.)</para> <para>Then install it and its documentation:</para> 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: <title>Installation of Coreutils</title> <para>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:</para> +Without the patch below, some of the Coreutils utilities +(<command>head</command>, <command>tail</command>, <command>sort</command>, +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:</para> <screen><userinput>patch -Np1 -i ../&coreutils-posixver-patch;</userinput></screen> @@ -37,20 +38,11 @@ the patch:</para> <screen><userinput>make</userinput></screen> -<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> - -<para>The meaning of the make parameter:</para> - -<itemizedlist> -<listitem><para><userinput>RUN_EXPENSIVE_TESTS=yes</userinput>: 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.</para></listitem> -</itemizedlist> +<para>(If you insist on testing the results, then issue: +<userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput>. The +<emphasis>RUN_EXPENSIVE_TESTS=yes</emphasis> 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.)</para> <para>And install the package:</para> 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.</para></listite <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make test</userinput>. 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.)</para> -<screen><userinput>make test</userinput></screen> - -<para>And install:</para> +<para>And install it:</para> <screen><userinput>make SCRIPTS="" install</userinput></screen> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>And install the package:</para> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>And install it:</para> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: <userinput>make +check</userinput>. 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).)</para> <para>And install the package:</para> 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.</para></listitem> <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>Then install them and their documentation:</para> 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:</para> cp include/asm/* /tools/include/asm cp -R include/asm-generic /tools/include</userinput></screen> -<para>Install the cross-platform kernel header files:</para> +<para>And finally install the cross-platform kernel header files:</para> <screen><userinput>cp -R include/linux /tools/include</userinput></screen> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>Then install it and its documentation:</para> 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 @@ <sect2> <title>Installation of Patch</title> -<para>Prepare Patch for compilation:</para> +<para>Prepare Patch for compilation (the preprocessor flag +<emphasis>-D_GNU_SOURCE</emphasis> is only needed on the PowerPC platform, on +other architectures you can leave it out):</para> <screen><userinput>CPPFLAGS=-D_GNU_SOURCE ./configure --prefix=/tools</userinput></screen> -<para>The preprocessor flag <emphasis>-D_GNU_SOURCE</emphasis> is only needed -on the PowerPC platform. On other architectures you can leave it out.</para> - <para>Compile the program:</para> <screen><userinput>make</userinput></screen> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>Then install it and its documentation:</para> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>Then install them and their documentation:</para> 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.</para> <screen><userinput>make</userinput></screen> -<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> - -<para>The meaning of the make parameter:</para> - -<itemizedlist> -<listitem><para><userinput>TZ=UTC</userinput>: 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 <xref linkend="chapter-bootscripts"/>.</para></listitem> -</itemizedlist> - -<para>Sometimes package test suites will give false failures. You can -consult the LFS Wiki at <ulink url="&wiki-root;"/> to verify that these -failures are normal. This applies to all tests throughout the book.</para> +<para>(If you insist on testing the results, then issue: +<userinput>TZ=UTC make test</userinput>. 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 <emphasis>TZ=UTC</emphasis> 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 <xref linkend="chapter-bootscripts"/>.)</para> <para>Install the package:</para> @@ -69,7 +56,7 @@ will need its internal headers.</para></warning> <!-- HACK - Force some whitespace to appease tidy --> <literallayout></literallayout> -<para>Make a necessary symbolic link:</para> +<para>And make a necessary symbolic link:</para> <screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen> 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 @@ <screen><userinput>make</userinput></screen> -<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> +<para>(If you insist on testing the results, then issue: +<userinput>make check</userinput>.)</para> <para>Then install them and their documentation:</para> |