aboutsummaryrefslogtreecommitdiffstats
path: root/chapter02
diff options
context:
space:
mode:
Diffstat (limited to 'chapter02')
-rw-r--r--chapter02/abouttestsuites.xml25
-rw-r--r--chapter02/chapter02.xml1
2 files changed, 26 insertions, 0 deletions
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>