diff options
Diffstat (limited to 'automake.texi')
-rw-r--r-- | automake.texi | 35 |
1 files changed, 24 insertions, 11 deletions
diff --git a/automake.texi b/automake.texi index cd58189d4..5533ce816 100644 --- a/automake.texi +++ b/automake.texi @@ -1070,17 +1070,30 @@ makes a distribution, and then tries to do a @code{VPATH} build. @node Tests @chapter Support for test suites -Automake supports a simple form of test suite. If the variable -@code{TESTS} is defined, its value is taken to be a list of programs to -run in order to do the testing. The programs can either be derived -objects or source objects; the generated rule will look both in -@var{srcdir} and @file{.}. - -The testing is done via @samp{make check}. The number of failures will -be printed at the end of the run. - -In the future there will be some support for test suites which use -@code{DejaGnu}. +Automake supports a two forms of test suite. + +If the variable @code{TESTS} is defined, its value is taken to be a list +of programs to run in order to do the testing. The programs can either +be derived objects or source objects; the generated rule will look both +in @var{srcdir} and @file{.}. The number of failures will be printed at +the end of the run. + +If @samp{dejagnu} appears in @code{AUTOMAKE_OPTIONS}, then the a +@code{dejagnu}-based test suite is assumed. The value of the variable +@code{DEJATOOL} is passed as the @code{--tool} argument to +@code{runtest}. The variables @code{EXPECT}, @code{RUNTEST} and +@code{RUNTESTFLAGS} can also be overridden to provide project-specific +values. For instance, you will need to do this if you are testing a +compiler toolchain, because the default values do not take into account +host and target names. +@opindex dejagnu +@vindex DEJATOOL +@vindex EXPECT +@vindex RUNTEST +@vindex RUNTESTFLAGS +@c FIXME xref dejagnu + +In either case, the testing is done via @samp{make check}. @node Options |