From f05e373e8a2736c410fd9e86cf0d6a226a78c10e Mon Sep 17 00:00:00 2001
From: Greg Schafer <greg@linuxfromscratch.org>
Date: Sat, 13 Sep 2003 10:22:12 +0000
Subject: Add new section about the test suites.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2801 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
---
 chapter01/changelog.xml       |  3 +++
 chapter02/abouttestsuites.xml | 25 +++++++++++++++++++++++++
 chapter02/chapter02.xml       |  1 +
 entities/chapter02.ent        |  4 +---
 index.xml                     |  4 ++--
 5 files changed, 32 insertions(+), 5 deletions(-)
 create mode 100644 chapter02/abouttestsuites.xml

diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml
index 947aee135..3976ecf3f 100644
--- a/chapter01/changelog.xml
+++ b/chapter01/changelog.xml
@@ -87,6 +87,9 @@
 </itemizedlist>
 </para></listitem>
 
+<listitem><para>September 13th, 2003 [greg]: Chapter 2 - Added new section
+about the test suites.</para></listitem>
+
 <listitem><para>September 12th, 2003 [jeremy]: Chapter 5 - Ncurses: Added
 description for the --without-ada configure switch.</para></listitem>
 
diff --git a/chapter02/abouttestsuites.xml b/chapter02/abouttestsuites.xml
new file mode 100644
index 000000000..4652ff0d5
--- /dev/null
+++ b/chapter02/abouttestsuites.xml
@@ -0,0 +1,25 @@
+<sect1 id="ch02-abouttestsuites">
+<title>About the test suites</title>
+<?dbhtml filename="abouttestsuites.html" dir="chapter02"?>
+
+<para>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 it's 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.</para>
+
+<para>Some test suites are more important than others. For example, the test
+suites for the core toolchain packages, GCC and Binutils, and the C library,
+Glibc, are of the utmost importance due to their central positioning in a
+properly functioning system. But be warned, the test suites for GCC and Glibc
+can take a very long period of time to complete, especially on slower
+hardware.</para>
+
+<para>As you progress through the book and encounter the build 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 it or not.</para>
+
+</sect1>
+
diff --git a/chapter02/chapter02.xml b/chapter02/chapter02.xml
index 4c4da4a24..f1619e7ba 100644
--- a/chapter02/chapter02.xml
+++ b/chapter02/chapter02.xml
@@ -4,6 +4,7 @@
 
 &c2-aboutlfs;
 &c2-aboutsbus;
+&c2-abouttestsuites;
 &c2-askforhelp;
 
 </chapter>
diff --git a/entities/chapter02.ent b/entities/chapter02.ent
index 29692f6dc..41d4ee246 100644
--- a/entities/chapter02.ent
+++ b/entities/chapter02.ent
@@ -1,7 +1,5 @@
 <!ENTITY chapter02 SYSTEM "../chapter02/chapter02.xml">
 <!ENTITY c2-aboutlfs SYSTEM "../chapter02/aboutlfs.xml">
 <!ENTITY c2-aboutsbus SYSTEM "../chapter02/aboutsbus.xml">
-<!ENTITY c2-download SYSTEM "../chapter02/download.xml">
-<!ENTITY c2-install SYSTEM "../chapter02/install.xml">
-<!ENTITY c2-platform SYSTEM "../chapter02/platform.xml">
+<!ENTITY c2-abouttestsuites SYSTEM "../chapter02/abouttestsuites.xml">
 <!ENTITY c2-askforhelp SYSTEM "../chapter02/askforhelp.xml">
diff --git a/index.xml b/index.xml
index 371133c22..1f6232b60 100644
--- a/index.xml
+++ b/index.xml
@@ -3,8 +3,8 @@
 				"/usr/share/docbook/docbookx.dtd" [
 
 
-<!ENTITY version "20030912">
-<!ENTITY releasedate "September 12th, 2003">
+<!ENTITY version "20030913">
+<!ENTITY releasedate "September 13th, 2003">
 <!ENTITY nbsp " ">
 
 <!ENTITY ftp-root "ftp://ftp.linuxfromscratch.org">
-- 
cgit v1.2.3-54-g00ecf