Re: --add-missing documentation (Debian bug #39542)

[Alexandre Duret-Lutz]

>>> "Eric" == Eric Dorland <address@hidden> writes:

 Eric> Hi,
 Eric> Attached is a patch from Jeremy Nimmer <address@hidden>. It
 Eric> addresses the Debian bug #39542 (see http://bugs.debian.org/39542 for
 Eric> the full logs). It basically addresses some issues with --add-missing
 Eric> that were not properly documented before. This patch applies cleanly
 Eric> to 1.7.2 and I've already applied it to my packages.

Thanks a lot!  I'm checking this in on branch-1-7 and HEAD as follows.  
It will be in 1.7.3.

2003-02-02  Jeremy Nimmer  <address@hidden>  (tiny change)

        For Debian Bug #39542:
        * automake.texi (Invoking Automake, Optional): Document how
        AC_CONFIG_AUX_DIR interacts with missing files.

Index: THANKS
===================================================================
RCS file: /cvs/automake/automake/THANKS,v
retrieving revision 1.186.2.16
diff -u -r1.186.2.16 THANKS
--- THANKS      16 Jan 2003 11:41:25 -0000      1.186.2.16
+++ THANKS      2 Feb 2003 10:43:03 -0000
@@ -87,6 +87,7 @@
 Jeff Bailey            address@hidden
 Jeff Garzik            address@hidden
 Jens Krüger            address@hidden
+Jeremy Nimmer          address@hidden
 Jerome Lovy            address@hidden
 Jerome Santini         address@hidden
 Jim Meyering           address@hidden
Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.305.2.14
diff -u -r1.305.2.14 automake.texi
--- automake.texi       31 Jan 2003 23:35:34 -0000      1.305.2.14
+++ automake.texi       2 Feb 2003 10:43:08 -0000
@@ -944,6 +944,12 @@
 By default Automake tries to make a symbolic link pointing to its own
 copy of the missing file; this can be changed with @code{--copy}.
 
+Many of the potentially-missing files are common scripts whose
+location may be specified via the @code{AC_CONFIG_AUX_DIR} macro.
+Therefore, @code{AC_CONFIG_AUX_DIR}'s setting affects whether a
+file is considered missing, and where the missing file is added
+(@pxref{Optional}).
+
 @item address@hidden
 @opindex --libdir
 Look for Automake data files in directory @var{dir} instead of in the
@@ -1159,13 +1165,23 @@
 @item AC_CONFIG_AUX_DIR
 Automake will look for various helper scripts, such as
 @file{mkinstalldirs}, in the directory named in this macro invocation.
-If not seen, the scripts are looked for in their @samp{standard}
-locations (either the top source directory, or in the source directory
-corresponding to the current @file{Makefile.am}, whichever is
-appropriate).  @xref{Input, , Finding `configure' Input, autoconf, The
-Autoconf Manual}.
address@hidden This list is accurate relative to version 1.7.2
+(The full list of scripts is: @file{config.guess}, @file{config.sub},
address@hidden, @file{elisp-comp}, @file{compile}, @file{install-sh},
address@hidden, @file{mdate-sh}, @file{missing}, @file{mkinstalldirs},
address@hidden, @file{texinfo.tex}, and @file{ylwrap}.)  Not all
+scripts are always searched for; some scripts will only be sought if the
+generated @file{Makefile.in} requires them.
 @cvindex AC_CONFIG_AUX_DIR
address@hidden FIXME: give complete list of things looked for in this directory
+
+If @code{AC_CONFIG_AUX_DIR} is not given, the scripts are looked for in
+their @samp{standard} locations.  For @file{mdate-sh},
address@hidden, and @file{ylwrap}, the standard location is the
+source directory corresponding to the current @file{Makefile.am}.  For
+the rest, the standard location is the first one of @file{.}, @file{..},
+or @file{../..} (relative to the top source directory) that provides any
+one of the helper scripts.  @xref{Input, , Finding `configure' Input,
+autoconf, The Autoconf Manual}.
 
 @item AC_CANONICAL_HOST
 Automake will ensure that @file{config.guess} and @file{config.sub}

-- 
Alexandre Duret-Lutz