misc: document TESTSUITEFLAGS in README-hacking

* README-hacking: Document -j and -k flags.
This commit is contained in:
Theophile Ranquet
2012-10-22 14:19:31 +00:00
committed by Akim Demaille
parent 0f92546f47
commit 6b1cbda1b9

View File

@@ -175,6 +175,28 @@ decide whether to update.
** make check ** make check
Use liberally. Use liberally.
** TESTSUITEFLAGS
The default is for make check to run all tests sequentially. This can be
very time consumming when checking repeatedly or on slower setups. This can
be sped up in two ways:
Using -j, in a make-like fashion, for example:
$ make check TESTSUITEFLAGS='-j8'
Running only the tests of a certain category, as specified in the AT files
with AT_KEYWORDS([[category]]). Categories include:
- c++, for c++ parsers
- deprec, for tests concerning deprecated constructs.
- glr, for glr parsers
- java, for java parsers
- report, for automaton dumps
To run a specific set of tests, use -k (for "keyword"). For example:
$ make check TESTSUITEFLAGS='-k c++'
Both can be combined.
** Typical errors ** Typical errors
If the test suite shows failures such as the following one If the test suite shows failures such as the following one