summaryrefslogtreecommitdiff
path: root/t/README
diff options
context:
space:
mode:
authorStefano Lattarini <stefano.lattarini@gmail.com>2012-10-27 12:59:41 +0200
committerStefano Lattarini <stefano.lattarini@gmail.com>2012-10-27 12:59:41 +0200
commit0610fc8ebe02125d556bd81b6a78c3306efd25e2 (patch)
tree8096f5fdce968bc5b227195fe75105ba8b46d97b /t/README
parentd8f47b194d55dfb31a116106032eaf81bdf5656e (diff)
downloadautomake-0610fc8ebe02125d556bd81b6a78c3306efd25e2.tar.gz
tests: prepare to move ./defs to t/ax/test-init.sh
We don't do this in a sweeping passage, because that would cause endless headaches in the synchronization between the maint, master and ng/master branches. Instead, we setup our framework to allow test scripts to work by sourcing either './defs' or 'test-init.sh', so that we'll be able to make the transition gradual and painless. * t/ax/test-init.sh: New, copied from the previous ./defs file. * defs: Simply work by sourcing the new file. * Makefile.am (dist_noinst_DATA): List the new file. * t/README: Adjust to mandate the sourcing of 'test-init.sh' rather than of './defs'. * t/c-demo.sh: Source 'test-init.sh' instead of ./defs. This is done to verify our new setup actually works. * t/ac-output-old.tap: Likewise. Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
Diffstat (limited to 't/README')
-rw-r--r--t/README21
1 files changed, 11 insertions, 10 deletions
diff --git a/t/README b/t/README
index 06f087f77..02cb3a5a9 100644
--- a/t/README
+++ b/t/README
@@ -142,8 +142,8 @@ Writing test cases
tools which can be taken for granted because they're listed in the
GNU Coding Standards (for example, 'gzip').
-* Include ./defs in every test script (see existing tests for examples
- of how to do this).
+* Include 'test-init.sh' in every test script (see existing tests for
+ examples of how to do this).
* Use the 'skip_' function to skip tests, with a meaningful message if
possible. Where convenient, use the 'warn_' function to print generic
@@ -162,7 +162,7 @@ Writing test cases
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.
+ test-init.sh.
* Some tests in the Automake testsuite are auto-generated; those tests
might have custom extensions, but their basename (that is, with such
@@ -173,14 +173,15 @@ Writing test cases
to be confused with auto-generated tests; for example, 'u-v-w.sh'
or 'option-w0.tap' are *not* valid name for hand-written tests.
-* ./defs brings in some commonly required files, and sets a skeleton
- configure.ac. If possible, append to this file. In some cases
- you'll have to overwrite it, but this should be the exception. Note
- that configure.ac registers Makefile.in but do not output anything by
+* test-init.sh brings in some commonly required files, and sets a skeleton
+ configure.ac. If possible, append to this file. In some cases you'll
+ have to overwrite it, but this should be the exception. Note that
+ configure.ac registers Makefile.in but do not output anything by
default. If you need ./configure to create Makefile, append AC_OUTPUT
- to configure.ac. In case you don't want ./defs to pre-populate your
- test directory (which is a rare occurrence), set the 'am_create_testdir'
- shell variable to "empty" before sourcing ./defs.
+ to configure.ac. In case you don't want your test directory to be
+ pre-populate by test-init.sh (this should be a rare occurrence), set
+ the 'am_create_testdir' shell variable to "empty" before sourcing
+ test-init.sh.
* By default, the testcases are run with the errexit shell flag on,
to make it easier to catch failures you might not have thought of.