summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorStefano Lattarini <stefano.lattarini@gmail.com>2011-01-19 20:20:37 +0100
committerRalf Wildenhues <Ralf.Wildenhues@gmx.de>2011-01-19 20:38:44 +0100
commit10315b6dc8fe65f86a901ee9692271b2e8e4f541 (patch)
treef823fc20e573487d381b8316a3d2244f9f7938df /doc
parentd652a1c0a5bf2f973c5328eed983b4df9ccd284f (diff)
downloadautomake-10315b6dc8fe65f86a901ee9692271b2e8e4f541.tar.gz
docs: automake testsuite doesn't use TESTS_ENVIRONMENT anymore
* doc/automake.texi (Simple Tests): Do not claim Automake uses TESTS_ENVIRONMENT for the perl driver. Instead, point to the parallel-tests driver. Signed-off-by: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
Diffstat (limited to 'doc')
-rw-r--r--doc/automake.texi14
1 files changed, 10 insertions, 4 deletions
diff --git a/doc/automake.texi b/doc/automake.texi
index 73c0e51b5..3d6a7b023 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8596,13 +8596,19 @@ variables for the test run; the environment variable @env{srcdir} is
set in the rule. If all your test programs are scripts, you can also
set @code{TESTS_ENVIRONMENT} to an invocation of the shell (e.g.
@samp{$(SHELL) -x} can be useful for debugging the tests), or any other
-interpreter. For instance the following setup is used by the Automake
-package to run four tests in Perl.
+interpreter. For instance, the following setup may be used to run tests
+with Perl:
+
@example
-TESTS_ENVIRONMENT = $(PERL) -Mstrict -I $(top_srcdir)/lib -w
-TESTS = Condition.pl DisjConditions.pl Version.pl Wrap.pl
+TESTS_ENVIRONMENT = $(PERL) -Mstrict -w
+TESTS = foo.pl bar.pl baz.pl
@end example
+Note that the @option{parallel-tests} driver provides a more elegant
+way to achieve the same effect, freeing the @code{TESTS_ENVIRONMENT}
+variable for the user to override (@pxref{Simple Tests using
+parallel-tests}).
+
@cindex Tests, expected failure
@cindex Expected test failure