FYI: site.exp doc

[Alexandre Duret-Lutz]

Committed on HEAD and branch-1-6.

2002-06-11  Alexandre Duret-Lutz  <address@hidden>

        * automake.texi (Tests): Document site.exp.  Update DejaGnu's url.

Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.271.2.3
diff -u -r1.271.2.3 automake.texi
--- automake.texi       10 Jun 2002 10:08:32 -0000      1.271.2.3
+++ automake.texi       11 Jun 2002 09:09:45 -0000
@@ -4018,12 +4018,11 @@
 
 @section DejaGNU Tests
 
-If @uref{ftp://prep.ai.mit.edu/pub/gnu/dejagnu-1.3.tar.gz,
address@hidden appears in @code{AUTOMAKE_OPTIONS}, then a
address@hidden test suite is assumed.  The variable
address@hidden is a list of names which are passed, one at a time, as
-the @code{--tool} argument to @code{runtest} invocations; it defaults to
-the name of the package.
+If @uref{ftp://ftp.gnu.org/gnu/dejagnu/, @samp{dejagnu}} appears in
address@hidden, then a @code{dejagnu}-based test suite is
+assumed.  The variable @code{DEJATOOL} is a list of names which are
+passed, one at a time, as the @code{--tool} argument to @code{runtest}
+invocations; it defaults to the name of the package.
 
 The variable @code{RUNTESTDEFAULTFLAGS} holds the @code{--tool} and
 @code{--srcdir} flags that are passed to dejagnu by default; this can be
@@ -4047,6 +4046,15 @@
 @vindex RUNTESTFLAGS
 @vindex AM_RUNTESTFLAGS
 @c FIXME xref dejagnu
+
address@hidden @file{site.exp}
+Automake will generate rules to create a local @file{site.exp} file,
+defining various variables detected by @code{./configure}.  This file
+is automatically read by DejaGnu.  It is ok for the user of a package
+to edit this file in order to tune the test suite.  However this is
+not the place where the test suite author should define new variables:
+this should be done elsewhere in the real test suite code.
+Especially, @file{site.exp} should not be distributed.
 
 In either case, the testing is done via @samp{make check}.
 

-- 
Alexandre Duret-Lutz