Test modules can be marked with some special status attributes. When a
test module has such an attribute,
gnulib-tool --import will not
include it by default.
The supported status attributes are:
Indicates that the test is testing C++ interoperability. Such a test is useful in a C++ or mixed C/C++ package, but is useless in a C package.
Indicates that the test takes a long time to compile or execute (more than five minutes or so). Such a test is better avoided in a release that is made for the general public.
Indicates that the test will request special privileges, for example, ask for the superuser password. Such a test may hang when run non-interactively and is therefore better avoided in a release that is made for the general public.
Indicates that the test is known to fail on some systems, and that there is no workaround about it. Such a test is better avoided in a release that is made for the general public.
gnulib-tool --import --with-tests will not include tests marked with
these attributes by default. When
gnulib-tool is invoked with one
of the options
will include tests despite the corresponding special status attribute.
gnulib-tool receives the option
it will include all tests regardless of their status attributes.
gnulib-tool --create-testdir --with-tests and
gnulib-tool --create-megatestdir --with-tests by default include all
tests of modules specified on the command line, regardless of their status
attributes. Tests of modules occurring as dependencies are not included
by default if they have one of these status attributes. The options
recognized here as well. Additionally,
understands the options
In order to mark a module with a status attribute, you need to add it to the module description, like this:
If only a part of a test deserves a particular status attribute, you
can split the module into a primary and a secondary test module,
foo-extra-tests. Then add a dependency
foo-extra-tests, and mark the
foo-extra-tests with the particular status attribute.