aboutsummaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL27
1 files changed, 27 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
index b5acedc..acb622a 100644
--- a/INSTALL
+++ b/INSTALL
@@ -224,6 +224,33 @@ You can specify 'stop-on-test-failure=y' when running 'make check' to
make the test run stop and exit with an error status immediately when a
failure occurs.
+ The GNU C Library pretty printers come with their own set of scripts
+for testing, which run together with the rest of the testsuite through
+'make check'. These scripts require the following tools to run
+successfully:
+
+ * Python 2.7.6/3.4.3 or later
+
+ Python is required for running the printers' test scripts.
+
+ * PExpect 4.0
+
+ The printer tests drive GDB through test programs and compare its
+ output to the printers'. PExpect is used to capture the output of
+ GDB, and should be compatible with the Python version in your
+ system.
+
+ * GDB 7.8 or later with support for Python 2.7.6/3.4.3 or later
+
+ GDB itself needs to be configured with Python support in order to
+ use the pretty printers. Notice that your system having Python
+ available doesn't imply that GDB supports it, nor that your
+ system's Python and GDB's have the same version.
+
+If these tools are absent, the printer tests will report themselves as
+'UNSUPPORTED'. Notice that some of the printer tests require the GNU C
+Library to be compiled with debugging symbols.
+
To format the 'GNU C Library Reference Manual' for printing, type
'make dvi'. You need a working TeX installation to do this. The
distribution builds the on-line formatted version of the manual, as Info