aboutsummaryrefslogtreecommitdiffstats
path: root/chapter02/abouttestsuites.xml
diff options
context:
space:
mode:
Diffstat (limited to 'chapter02/abouttestsuites.xml')
-rw-r--r--chapter02/abouttestsuites.xml25
1 files changed, 25 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>
+