Changeset 5da8aa0 for BOOK/final-preps/abouttestsuites.xml

Timestamp:

Feb 21, 2006, 2:04:25 AM (18 years ago)

Author:

Jim Gifford <clfs@…>

Branches:

clfs-1.2, clfs-2.1, clfs-3.0.0-systemd, clfs-3.0.0-sysvinit, master, systemd, sysvinit

Children:

f8f27bf9

Parents:

9860952

Message:

r1023@server (orig r1021): chris | 2006-01-08 00:36:31 -0800
Rewrote description of build process and test suite info, and added mention of test suites to some packages.

File:

• BOOK/final-preps/abouttestsuites.xml (modified) (2 diffs)

BOOK/final-preps/abouttestsuites.xml

@@ -11 +11 @@
   <title>About the Test Suites</title>
 
-  <para>TO BE REWRITTEN (and maybe moved to final-system chapter)</para>
-
   <para>Most packages provide a test suite. Running the test suite for a
   newly built package is a good idea because it can provide a <quote>sanity
@@ -20 +18 @@
   that the package is totally bug free.</para>
 
-  <para>Some test suites are more important than others. For example,
-  the test suites for the core toolchain packages&mdash;GCC, Binutils, and
-  Glibc&mdash;are of the utmost importance due to their central role in a
-  properly functioning system. The test suites for GCC and Glibc can
-  take a very long time to complete, especially on slower hardware, but
-  are strongly recommended.</para>
-
-  <note>
-    <para>It is not possible to run testsuites when cross-compiling, so there
-    are no instructions given for running testsuites until
-    <xref linkend="chapter-building-system"/>.</para>
-  </note>
-
-  <para>A common issue with running the test suites for Binutils and GCC
-  is running out of pseudo terminals (PTYs). This can result in a high
-  number of failing tests. This may happen for several reasons, but the
-  most likely cause is that the host system does not have the
-  <systemitem class="filesystem">devpts</systemitem> file system set up
-  correctly. This issue is discussed in greater detail at
-  <ulink url="http://www.linuxfromscratch.org/lfs/faq.html#no-ptys"/>.</para>
-
-  <para>Sometimes package test suites will fail, but for reasons which the
-  developers are aware of and have deemed non-critical. Consult the logs located
-  at <ulink url="&test-results;"/> to verify whether or not these failures are
-  expected. This site is valid for all tests throughout this book.</para>
+  <para>It is not possible to run testsuites when cross-compiling, so package installation instructions do not explain how to run testsuites until <xref linkend="chapter-building-system"/>.</para>
 
 </sect1>