From 2e959a815c6f144441a59761a2b4dc51d28ec776 Mon Sep 17 00:00:00 2001 From: Ralf Wildenhues Date: Mon, 13 Apr 2009 13:36:19 +0200 Subject: [PATCH] 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 --- ChangeLog | 6 ++++++ doc/automake.texi | 8 +++++++- 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index bfad4c3..0737903 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,11 @@ 2009-04-13 Ralf Wildenhues + 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 77beee3..453fff9 100644 --- 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 -- 2.7.4