Re: AT_line undefined when trying to use autotest

[Eric Blake]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

According to Christopher Hulbert on 2/22/2008 2:18 PM:
| I'm looking into converting some existing test methods to use
| autotest. In doing so I ran into a problem that autom4te complained
| AT_line was undefined.

You invoked AT_CHECK outside of a AT_SETUP/AT_CLEANUP pair.  Hmm, maybe it
would be nicer to make AT_CHECK issue a nicer warning if users make this
mistake.  But for now, I'll just do a documentation patch:

- --
Don't work too hard, make some time for fun as well!

Eric Blake             address@hidden
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFHv1rx84KuGfSFAYARAnKMAKDAAbr4lK+TyQbWvhF3Sw6nfWg7/ACfVMaH
9k212FyAlIUhD+R5OC7CzEI=
=VloK
-----END PGP SIGNATURE-----

>From e53a6566d0935b22f83b733abaf6df1d1d662a48 Mon Sep 17 00:00:00 2001
From: Eric Blake <address@hidden>
Date: Fri, 22 Feb 2008 16:23:48 -0700
Subject: [PATCH] Improve documentation for writing autotest suites.

* doc/autoconf.texi (Writing Testsuites) <AT_CHECK>: Mention that
checks must live inside a test group.
Reported by Christopher Hulbert.

Signed-off-by: Eric Blake <address@hidden>
---
 ChangeLog         |    7 +++++++
 doc/autoconf.texi |    2 ++
 2 files changed, 9 insertions(+), 0 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index fc0183b..c48ebce 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-02-22  Eric Blake  <address@hidden>
+
+       Improve documentation for writing autotest suites.
+       * doc/autoconf.texi (Writing Testsuites) <AT_CHECK>: Mention that
+       checks must live inside a test group.
+       Reported by Christopher Hulbert.
+
 2008-02-21  Eric Blake  <address@hidden>
 
        Sync git-version-gen from upstream.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 07c6699..ea5997a 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -20227,6 +20227,8 @@ 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}.
 
+This macro must be invoked in between @code{AT_SETUP} and @code{AT_CLEANUP}.
+
 @c Previously, we had this:
 @c  The @var{commands} @emph{must not} redirect the standard output, nor the
 @c  standard error.
-- 
1.5.4