* doc/automake.texi (Libtool Modules): Make clearer that -module

should appear explicitly in _LDFLAGS.

diff --git a/ChangeLog b/ChangeLog
index 6398f306c44f1e297092e0b2e7b15930ee4522bd..99e421c4251793789d7b905a545cbe9070dab235 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-11-10  Alexandre Duret-Lutz  <adl@gnu.org>
+
+       * doc/automake.texi (Libtool Modules): Make clearer that -module
+       should appear explicitly in _LDFLAGS.
+
 2004-11-09  Alexandre Duret-Lutz  <adl@gnu.org>
 
        * aclocal.in (parse_arguments): Correctly recognize --print-ac-dir.

diff --git a/doc/automake.texi b/doc/automake.texi
index 5833edc4076e02f563e1634ab2c71b39c962602d..b995095365efbcaf93dabae36af264359fab9b66 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -3298,12 +3298,22 @@ mymodule_la_SOURCES = doit.c
 mymodule_la_LDFLAGS = -module
 @end example
 
-Ordinarily, Automake requires that a Library's name starts with
+Ordinarily, Automake requires that a library's name starts with
 @samp{lib}.  However, when building a dynamically loadable module you
-might wish to use a "nonstandard" name.
-
-If @samp{mymodule_la_SOURCES} is not specified, then it defaults to the single
-file @file{mymodule.c} (@pxref{Default _SOURCES}).
+might wish to use a "nonstandard" name.  Automake will not complain
+about such nonstandard name if it knows the library being built is a
+libtool module, i.e., if @samp{-module} explicitly appears in the
+library's @code{_LDFLAGS} variable (or in the common @code{AM_LDFLAGS}
+variable when no per-library @code{_LDFLAGS} variable is defined).
+
+As always, @code{AC_SUBST} variables are black boxes to Automake since
+their values are not yet known when @command{automake} is run.
+Therefore if @code{-module} is set via such a variable, Automake
+cannot notice it and will proceed as if the library was an ordinary
+libtool library, with strict naming.
+
+If @samp{mymodule_la_SOURCES} is not specified, then it defaults to
+the single file @file{mymodule.c} (@pxref{Default _SOURCES}).
 
 @node Libtool Flags
 @subsection _LIBADD and _LDFLAGS