diff options
| -rw-r--r-- | chapter01/changelog.xml | 3 | ||||
| -rw-r--r-- | chapter02/abouttestsuites.xml | 25 | ||||
| -rw-r--r-- | chapter02/chapter02.xml | 1 | ||||
| -rw-r--r-- | entities/chapter02.ent | 4 | ||||
| -rw-r--r-- | index.xml | 4 |
5 files changed, 32 insertions, 5 deletions
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"> @@ -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"> |