automake: Declaring Custom Test Drivers

1 
1 15.3.2 Declaring Custom Test Drivers
1 ------------------------------------
1 
1 Custom testsuite drivers are declared by defining the make variables
1 ‘LOG_DRIVER’ or ‘EXT_LOG_DRIVER’ (where EXT must be declared in
1 ‘TEST_EXTENSIONS’).  They must be defined to programs or scripts that
1 will be used to drive the execution, logging, and outcome report of the
1 tests with corresponding extensions (or of those with no registered
1 extension in the case of ‘LOG_DRIVER’).  Clearly, multiple distinct test
1 drivers can be declared in the same ‘Makefile.am’.  Note moreover that
1 the ‘LOG_DRIVER’ variables are _not_ a substitute for the ‘LOG_COMPILER’
1 variables: the two sets of variables can, and often do, usefully and
1 legitimately coexist.
1 
1    The developer-reserved variable ‘AM_LOG_DRIVER_FLAGS’ and the
1 user-reserved variable ‘LOG_DRIVER_FLAGS’ can be used to define flags
1 that will be passed to each invocation of ‘LOG_DRIVER’, with the
1 user-defined flags obviously taking precedence over the
1 developer-reserved ones.  Similarly, for each extension EXT declared in
1 ‘TEST_EXTENSIONS’, flags listed in ‘AM_EXT_LOG_DRIVER_FLAGS’ and
1 ‘EXT_LOG_DRIVER_FLAGS’ will be passed to invocations of
1 ‘EXT_LOG_DRIVER’.
1