* doc/libtool.texi (Invoking libtoolize): Improve documentation

for use of ACLOCAL_AMFLAGS and AC_CONFIG_MACRO_DIR.

diff --git a/ChangeLog b/ChangeLog
index 420e302ad9d1da3b5a9ca4fb351f44d69bd03b9a..8b4545d210fd5ff213f158e5b0c6ff01cfa6a0b5 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2004-11-22  Gary V. Vaughan  <gary@gnu.org>
- 
+
+       * doc/libtool.texi (Invoking libtoolize): Improve documentation
+       for use of ACLOCAL_AMFLAGS and AC_CONFIG_MACRO_DIR.
+
        * configure.ac, Makefile.am, libltdl/Makefile.am,
        libltdl/loaders/Makefile.am, libtoolize.m4sh, doc/libtool.texi:
        Revert libtool--release--2.0--patch-68, my 2004-11-14 patch for

diff --git a/doc/libtool.texi b/doc/libtool.texi
index ab314e0911bb17173a561edb8a52f3f72136ac6b..997ec90894628c7f1699c598abe72780f24a808c 100644 (file)
--- a/doc/libtool.texi
+++ b/doc/libtool.texi
@@ -2212,6 +2212,28 @@ If @command{libtoolize} detects an explicit call to
 autoconf, The Autoconf Manual}) in your @file{configure.ac}, it will
 put the Libtool macros in the specified directory.
 
+In the future other Autotools will automatically check the contents of
+@code{AC_CONFIG_MACRO_DIR}, but at the moment it is more portable to
+add the macro directory to @code{ACLOCAL_AMFLAGS} in
+@file{Makefile.am}, which is where the tools currently look.  If
+@command{libtoolize} doesn't see @code{AC_CONFIG_MACRO_DIR}, it too
+will honour the first @samp{-I} argument in @code{ACLOCAL_AMFLAGS}
+when choosing a directory to store libtool configuration macros in.
+It is perfectly sensible to use both @code{AC_CONFIG_MACRO_DIR} and
+@code{ACLOCAL_AMFLAGS}, as long as they are kept in synchronisation.
+
+@example
+ACLOCAL_AMFLAGS = -I m4
+@endif
+
+When you bootstrap your project with @command{aclocal}, then you will
+need to explicitly pass the same macro directory with
+@command{aclocal}'s @samp{-I} flag:
+
+@example
+trick$ @kbd{aclocal -I m4}
+@end example
+
 @findex AC_CONFIG_AUX_DIR
 If @command{libtoolize} detects an explicit call to
 @code{AC_CONFIG_AUX_DIR} (@pxref{Input, , The Autoconf Manual,