Sfoglia il codice sorgente

Add new section about the test suites.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2801 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Greg Schafer 22 anni fa
parent
commit
f05e373e8a
5 ha cambiato i file con 32 aggiunte e 5 eliminazioni
  1. 3 0
      chapter01/changelog.xml
  2. 25 0
      chapter02/abouttestsuites.xml
  3. 1 0
      chapter02/chapter02.xml
  4. 1 3
      entities/chapter02.ent
  5. 2 2
      index.xml

+ 3 - 0
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>
 

+ 25 - 0
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>
+

+ 1 - 0
chapter02/chapter02.xml

@@ -4,6 +4,7 @@
 
 &c2-aboutlfs;
 &c2-aboutsbus;
+&c2-abouttestsuites;
 &c2-askforhelp;
 
 </chapter>

+ 1 - 3
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">

+ 2 - 2
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">