From 17ab72d031a7636d25a379e266eb8a10cc3d3db9 Mon Sep 17 00:00:00 2001 From: Alexandre Duret-Lutz Date: Tue, 9 Nov 2004 23:39:56 +0000 Subject: [PATCH] * doc/automake.texi (Libtool Modules): Make clearer that -module should appear explicitly in _LDFLAGS. --- ChangeLog | 5 +++++ doc/automake.texi | 20 +++++++++++++++----- 2 files changed, 20 insertions(+), 5 deletions(-) diff --git a/ChangeLog b/ChangeLog index 6398f306..99e421c4 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2004-11-10 Alexandre Duret-Lutz + + * doc/automake.texi (Libtool Modules): Make clearer that -module + should appear explicitly in _LDFLAGS. + 2004-11-09 Alexandre Duret-Lutz * aclocal.in (parse_arguments): Correctly recognize --print-ac-dir. diff --git a/doc/automake.texi b/doc/automake.texi index 5833edc4..b9950953 100644 --- 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 -- 2.43.5