update --no-cache doc (Was: Re: [Bug-tar] compile problems with tar-1.13.93)

[Alexandre Duret-Lutz]

>>> "Paul" == Paul Eggert <address@hidden> writes:

[...]
 Paul> This reminds me of an Autoconf patch by Alexandre Duret-Lutz that
 Paul> Akim Demaille didn't like; see
 Paul> <http://mail.gnu.org/archive/html/bug-autoconf/2003-11/msg00180.html>.
 Paul> I'm not sure what the status of the "I hate caches" school is, so
 Paul> I'll CC: this to bug-automake and bug-autoconf.
[...]

Thanks for raising this again, I had completely forgotten about it.

Here is a patch that goes Akim's way.  Since we cannot change the
meaning of Autoconf, people must adjust their ~/.autom4te.cfg.


2004-03-19  Alexandre Duret-Lutz  <address@hidden>

        * doc/autoconf.texi (autom4te Invocation): Language Autoconf
        inherits from language Autoconf-without-aclocal-m4.
        (Customizing autom4te): Adjust example; the cache must now be
        disabled for language Autoconf-without-aclocal-m4.

Index: doc/autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.804
diff -u -r1.804 autoconf.texi
--- doc/autoconf.texi   19 Mar 2004 08:57:51 -0000      1.804
+++ doc/autoconf.texi   19 Mar 2004 20:48:20 -0000
@@ -8331,7 +8331,7 @@
 
 @table @option
 @item address@hidden
address@hidden -l address@hidden
address@hidden -l @var{language}
 Use the @var{language} Autom4te library.  Current languages include:
 
 @table @code
@@ -8344,12 +8344,14 @@
 @item Autotest
 create Autotest executable test suites.
 
address@hidden Autoconf
-create Autoconf executable configure scripts.
-
 @item Autoconf-without-aclocal-m4
 create Autoconf executable configure scripts without
 reading @file{aclocal.m4}.
+
address@hidden Autoconf
+create Autoconf executable configure scripts.  This language inherits
+all the characteristics of @code{Autoconf-without-aclocal-m4} and will
+additionally read @file{aclocal.m4}.
 @end table
 
 @item address@hidden
@@ -8398,9 +8400,9 @@
 ## User Preferences.  ##
 ## ------------------ ##
 
-begin-language: "Autoconf"
+begin-language: "Autoconf-without-aclocal-m4"
 args: --no-cache
-end-language: "Autoconf"
+end-language: "Autoconf-without-aclocal-m4"
 @end verbatim
 
 
-- 
Alexandre Duret-Lutz