automake-1.16: Declaring Custom Test Drivers

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