From: Gary V. Vaughan <gary@gnu.org>
Date: Mon, 22 Nov 2004 21:38:35 +0000 (+0000)
Subject: * doc/libtool.texi (Invoking libtoolize): Improve documentation
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=295e250be915132ce0e15e4d178a0255794d458c;p=thirdparty%2Flibtool.git

* doc/libtool.texi (Invoking libtoolize): Improve documentation
for use of ACLOCAL_AMFLAGS and AC_CONFIG_MACRO_DIR.
---

diff --git a/ChangeLog b/ChangeLog
index 420e302ad..8b4545d21 100644
--- 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 ab314e091..997ec9089 100644
--- 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,