manual: Add note about parallelism and tests ordering.

* doc/automake.texi (Simple Tests using parallel-tests):
Dependencies between test logs work for tests with known
extensions only.  Hint that tests should be prepared to be run
in parallel.

Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>

diff --git a/ChangeLog b/ChangeLog
index bfad4c3cef261fc0487db5a832ed301bb84ab61b..0737903c9978612d790a3f535528a6c2cbbfbddd 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2009-04-13  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>
 
+       manual: Add note about parallelism and tests ordering.
+       * doc/automake.texi (Simple Tests using parallel-tests):
+       Dependencies between test logs work for tests with known
+       extensions only.  Hint that tests should be prepared to be run
+       in parallel.
+
        Fix maintainer-check failure.
        * tests/suffix13.test: Use Exit not exit.
 

diff --git a/doc/automake.texi b/doc/automake.texi
index 77beee3ebe16c6042435ba6740a57366327ec9ea..453fff940d74087fcab20c1687eca5ce008b99fd 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8648,7 +8648,13 @@ foo-execute.log: foo-compile.log
 @noindent
 Please note that this ordering ignores the @emph{results} of required
 tests, thus the test @file{foo-execute.test} is run even if the test
-@file{foo-compile.test} failed or was skipped beforehand.
+@file{foo-compile.test} failed or was skipped beforehand.  Further,
+please note that specifying such dependencies currently works only for
+tests that end in one of the suffixes listed in @code{TEST_EXTENSIONS}.
+
+Tests without such specified dependencies may be run concurrently with
+parallel @command{make -j@var{N}}, so be sure they are prepared for
+concurrent execution.
 
 @cindex Unit tests
 The combination of lazy test execution and correct dependencies between