25-fyi-doc-at-check.patch

[Akim Demaille]

Index: ChangeLog
from  Akim Demaille  <address@hidden>
        
        * doc/autoconf.texi (Writing testsuite.at) <AT_CHECK>: Complete.
        * lib/autotest/general.m4 (AT_INIT): Use the relative dir when
        looking for ChangeLogs.
        
Index: doc/autoconf.texi
--- doc/autoconf.texi Wed, 15 Aug 2001 18:25:22 +0200 akim
+++ doc/autoconf.texi Fri, 17 Aug 2001 08:35:55 +0200 akim
@@ -11267,26 +11267,29 @@ subshell.  It accepts a single argument,
 @defmac AT_DATA (@var{file}, @var{contents})
 @atindex DATA
 Initialize an input data @var{file} with given @var{contents}.  Of
-course, @var{contents} might have to be properly quoted between square
-brackets to protect against included commas or spurious @code{m4}
-expansion.  The contents ought to end with an end of line.
+course, @var{contents} has to be properly quoted between square brackets
+to protect against included commas or spurious @code{m4} expansion.  The
+contents ought to end with an end of line.
 @end defmac
 
 @defmac AT_CHECK (@var{commands}, @ovar{status = 0}, @ovar{stdout}, 
@ovar{stderr})
 @atindex CHECK
-This macro has up to four arguments: @var{commands}, @var{status},
address@hidden and @var{stderr}.  The @var{commands} argument is
-mandatory, and @code{m4} quoting is often useful.
+Execute a test by performing given shell @var{commands}.  These commands
+should normally exit with @var{status}, while producing expected
address@hidden and @var{stderr} contents.  If @var{commands} exits with
+status 77, then the whole test group is skipped.
 
-The macro executes 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.  Unless empty,
address@hidden is a decimal integer; exit status is not checked if
address@hidden is empty.  The special word @code{expout} for @var{stdout}
-means that file @file{expout} contents has been preset to the expected
-standard output.  The special word @code{experr} for @var{stderr} means
-that file @file{experr} contents has been preset to the expected
-standard error output.
+The @var{commands} @emph{must not} redirect the standard output, nor the
+standard error.
+
+If @var{status}, or @var{stdout}, or @var{stderr} is @samp{ignore}, then
+the corresponding value is not checked.
+
+The special value @samp{expout} for @var{stdout} means the expected
+output of the @var{commands} is the content of the file @file{expout}.
+If @var{stdout} is @samp{stdout}, then the standard output of the
address@hidden is available for further tests in the file @file{stdout}.
+Similarly for @var{stderr} with @samp{expout} and @samp{stderr}.
 @end defmac
 
 
Index: lib/autotest/general.m4
--- lib/autotest/general.m4 Sun, 12 Aug 2001 16:04:28 +0200 akim
+++ lib/autotest/general.m4 Fri, 17 Aug 2001 11:15:06 +0200 akim
@@ -226,8 +226,10 @@ Tests:
     echo
 
     # Try to find a few ChangeLogs in case it might help determining the
-    # exact version.
-    find "$at_top_srcdir" -name ChangeLog \
+    # exact version.  Use the relative dir: if the top dir is a symlink,
+    # find will not follow it (and options to follow the links are not
+    # portable), which would result in no output here.
+    find "$top_srcdir" -name ChangeLog \
       -exec echo {} : ';' \
       -exec sed 's/^/| /;10q' {} ';' \
       -exec echo ';'