summaryrefslogtreecommitdiff
path: root/t/README
diff options
context:
space:
mode:
authorStefano Lattarini <stefano.lattarini@gmail.com>2012-05-15 16:12:09 +0200
committerStefano Lattarini <stefano.lattarini@gmail.com>2012-05-18 14:03:11 +0200
commit7b142a7b363a49be43ff861abc2dca5af9593f9d (patch)
treee744359ac6bccf1714314ffd1d548bd858960739 /t/README
parent8084ae1b520862e03201d3bddfe01f3c8d197d1c (diff)
downloadautomake-7b142a7b363a49be43ff861abc2dca5af9593f9d.tar.gz
tests: use 'parallel-tests' Automake option by default
This will help our transition from 'serial-tests' to 'parallel-tests' as the default test suite driver enabled by a TESTS assignment in the input Makefile.am. Note that that change of default will only take place in master, though. * defs: Pass the 'parallel-tests' option to the AM_INIT_AUTOMAKE invocation in the created 'configure.ac' stub, unless the variable 'am_serial_tests' is set to "yes". Don't pay attention anymore to the 'am_parallel_tests' variable, that's obsolete now. * defs-static.in: Warn if the 'am_serial_tests' variable is set in the environment; conversely, don't warn anymore about 'am_parallel_tests' being set in the environment. * Makefile.am (AM_TESTS_ENVIRONMENT): Nullify the 'am_serial_tests' variable instead of the now-obsolete 'am_parallel_tests' one. * syntax-checks.mk (sc_tests_obsolete_variables): Also warn against uses of 'am_parallel_tests', which is now deprecated in favor of 'am_serial_tests'. Similarly, if a use of 'parallel_tests' is seen, suggest using 'am_serial_tests' instead, not 'am_parallel_tests'. * gen-testsuite-part: Now that we use the 'parallel-tests' by default in our tests, we need to completely change the logic and semantics of generation of sibling tests for those tests that check the Automake generated testsuite harness itself. Do that, and give a complete explanation of the new logic and semantics in the relevant comments. * t/README: Update. * Lots of test cases: Adjust. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Diffstat (limited to 't/README')
-rw-r--r--t/README15
1 files changed, 10 insertions, 5 deletions
diff --git a/t/README b/t/README
index 75dae9e20..5f967d271 100644
--- a/t/README
+++ b/t/README
@@ -173,11 +173,16 @@ Do
set-up of a test scenario, you can use the 'framework_fail_' function
instead.
- For tests that use the 'parallel-tests' Automake option, set the shell
- variable 'am_parallel_tests' to "yes" before including ./defs. For
- tests that are *not* meant to work with the 'parallel-tests' Automake
- option (these should be very very few), set the shell variable
- 'am_parallel_tests' to "no" before including ./defs.
+ For those tests checking the Automake-provided test harnesses that are
+ expected to work also when the 'serial-tests' Automake option is used
+ (thus causing the serial testsuite harness to be used in the generated
+ Makefile), place a line containing "try-with-serial-tests" somewhere
+ in the file. That will ensure that the 'gen-testsuite-part' script
+ generates a sibling of that test which uses the serial harness instead
+ of the parallel one. For those tests that are *not* meant to work with
+ the parallel testsuite harness at all (these should be very very few),
+ set the shell variable 'am_serial_tests' to "yes" before including
+ ./defs.
Some tests in the Automake testsuite are auto-generated; those tests
might have custom extensions, but their basename (that is, with such