* gdbint.texinfo (Testsuite): Document parallel make check.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 1455a1e5f00678f40c56e663de982625e9da872b..6842ec39ab1026a5ff5a4c87cc1f4b3cde83e8f7 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,7 @@
+2009-07-09  Tom Tromey  <tromey@redhat.com>
+
+       * gdbint.texinfo (Testsuite): Document parallel make check.
+
 2009-07-09  Tom Tromey  <tromey@redhat.com>
 
        * gdbint.texinfo (Testsuite): Document test transcripts.

diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo
index 3351a15fde4d3119d0d8dedf417db6e46ee207c3..b1c045218b456d7064c33b1711c0b4e07a406bad 100644 (file)
--- a/gdb/doc/gdbint.texinfo
+++ b/gdb/doc/gdbint.texinfo
@@ -7519,6 +7519,16 @@ make check RUNTESTFLAGS='@var{tests}'
 where @var{tests} is a list of test script file names, separated by
 spaces.
 
+If you use GNU make, you can use its @option{-j} option to run the
+testsuite in parallel.  This can greatly reduce the amount of time it
+takes for the testsuite to run.  In this case, if you set
+@code{RUNTESTFLAGS} then, by default, the tests will be run serially
+even under @option{-j}.  You can override this and force a parallel run
+by setting the @code{make} variable @code{FORCE_PARALLEL} to any
+non-empty value.  Note that the parallel @kbd{make check} assumes
+that you want to run the entire testsuite, so it is not compatible
+with some dejagnu options, like @option{--directory}.
+
 The ideal test run consists of expected passes only; however, reality
 conspires to keep us from this ideal.  Unexpected failures indicate
 real problems, whether in @value{GDBN} or in the testsuite.  Expected