aboutsummaryrefslogtreecommitdiffstats
path: root/chapter04/abouttestsuites.xml
diff options
context:
space:
mode:
authorManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-15 12:10:43 +0000
committerManuel Canales Esparcia <manuel@linuxfromscratch.org>2006-01-15 12:10:43 +0000
commit6a3b6af43583312b18dcae4d63d4f40737eff771 (patch)
tree0c183bd68f95a1e9f9ac1ff20a24d0fe04fa1c84 /chapter04/abouttestsuites.xml
parentb0ed1af225e305fa127907374a03db11748daf9e (diff)
Indented chapter 04.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7275 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter04/abouttestsuites.xml')
-rw-r--r--chapter04/abouttestsuites.xml88
1 files changed, 45 insertions, 43 deletions
diff --git a/chapter04/abouttestsuites.xml b/chapter04/abouttestsuites.xml
index 19993637d..1a08bedea 100644
--- a/chapter04/abouttestsuites.xml
+++ b/chapter04/abouttestsuites.xml
@@ -1,50 +1,52 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
+
<sect1 id="prepare-abouttestsuites">
-<title>About the Test Suites</title>
-<?dbhtml filename="abouttestsuites.html"?>
-
-<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
-check</quote> indicating that everything compiled correctly. A test suite
-that passes its set of checks usually proves that the package is
-functioning as the developer intended. It does not, however, guarantee
-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>Experience has shown that there is little to be gained
-from running the test suites in <xref
-linkend="chapter-temporary-tools"/>. There can be no escaping the fact
-that the host system always exerts some influence on the tests in that
-chapter, often causing inexplicable failures. Because the tools built
-in <xref linkend="chapter-temporary-tools"/> are temporary and
-eventually discarded, we do not recommend running the test suites in
-<xref linkend="chapter-temporary-tools"/> for the average reader. The
-instructions for running those test suites are provided for the
-benefit of testers and developers, but they are strictly
-optional.</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 in <xref
-linkend="chapter-temporary-tools"/>.</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>
+ <?dbhtml filename="abouttestsuites.html"?>
-</sect1>
+ <title>About the Test Suites</title>
+
+ <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
+ check</quote> indicating that everything compiled correctly. A test suite
+ that passes its set of checks usually proves that the package is
+ functioning as the developer intended. It does not, however, guarantee
+ 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>Experience has shown that there is little to be gained from running
+ the test suites in <xref linkend="chapter-temporary-tools"/>. There can be
+ no escaping the fact that the host system always exerts some influence on
+ the tests in that chapter, often causing inexplicable failures. Because
+ the tools built in <xref linkend="chapter-temporary-tools"/> are temporary
+ and eventually discarded, we do not recommend running the test suites in
+ <xref linkend="chapter-temporary-tools"/> for the average reader. The
+ instructions for running those test suites are provided for the benefit of
+ testers and developers, but they are strictly optional.</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 in <xref
+ linkend="chapter-temporary-tools"/>.</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>
+
+</sect1>