18doc-AT_CHECK-optional-shell-code.diff

[derek]

Index: ChangeLog

2003-08-16  Derek Price <address@hidden>

        * doc/autoconf.texi (Writing testsuite.at): Document RUN-IF-FAIL &
        RUN-IF-PASS optional arguments.

Index: doc/autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.749
diff -u -r1.749 autoconf.texi
--- doc/autoconf.texi   7 Aug 2003 05:13:09 -0000       1.749
+++ doc/autoconf.texi   16 Aug 2003 16:04:22 -0000
@@ -14401,12 +14401,14 @@
 expansion.  The contents ought to end with an end of line.
 @end defmac
 
address@hidden AT_CHECK (@var{commands}, @dvar{status, @samp{0}}, 
@ovar{stdout}, @ovar{stderr})
address@hidden AT_CHECK (@var{commands}, @dvar{status, @samp{0}}, 
@ovar{stdout}, @ovar{stderr}, @ovar{run-if-fail}, @ovar{run-if-pass})
 @atindex CHECK
 Execute a test by performing given shell @var{commands}.  These commands
 should normally exit with @var{status}, while producing expected
 @var{stdout} and @var{stderr} contents.  If @var{commands} exit with
-status 77, then the whole test group is skipped.
+status 77, then the whole test group is skipped.  Otherwise, if this test
+fails, run shell commands @var{run-if-fail} or, if this test passes, run shell
+commands @var{run-if-pass}.
 
 The @var{commands} @emph{must not} redirect the standard output, nor the
 standard error.