From 10315b6dc8fe65f86a901ee9692271b2e8e4f541 Mon Sep 17 00:00:00 2001 From: Stefano Lattarini Date: Wed, 19 Jan 2011 20:20:37 +0100 Subject: [PATCH] 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 --- ChangeLog | 8 ++++++++ doc/automake.texi | 14 ++++++++++---- 2 files changed, 18 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index c26f1ab8a..31ff0098f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2011-01-19 Stefano Lattarini + Ralf Wildenhues + + 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. + 2011-01-19 Ralf Wildenhues Allow _AM_DEPENDENCIES to be used later in configure. 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 -- 2.47.2