diff --git a/ChangeLog b/ChangeLog index 2939bebb..3902c191 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 1999-01-09 Ben Elliston + * autoconf.texi (AC_CHECK_LIB): Explain more. Contributed by Bob + Friesenhahn . + (UPDATED): Bump to 1999. + * config.guess: Distinguish between OpenStep and NeXTStep platforms. Contributed by Wilfredo Sanchez . diff --git a/autoconf.texi b/autoconf.texi index ce02ea1c..1eb6551c 100644 --- a/autoconf.texi +++ b/autoconf.texi @@ -8,7 +8,7 @@ @set EDITION 2.13 @set VERSION 2.13 -@set UPDATED December 1998 +@set UPDATED January 1999 @iftex @finalout @@ -27,7 +27,8 @@ This file documents the GNU Autoconf package for creating scripts to configure source code packages using templates and an @code{m4} macro package. -Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998 Free Software Foundation, Inc. +Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999 Free Software +Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -61,7 +62,8 @@ by the Foundation. @page @vskip 0pt plus 1filll -Copyright @copyright{} 1992, 93, 94, 95, 96, 98 Free Software Foundation, Inc. +Copyright @copyright{} 1992, 93, 94, 95, 96, 98, 99 Free Software +Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -1841,17 +1843,25 @@ name of the library; e.g., to check for @samp{-lmp}, use @samp{mp} as the @var{library} argument. @var{action-if-found} is a list of shell commands to run if the link -with the library succeeds; @var{action-if-not-found} is a list of -shell commands to run if the link fails. If @var{action-if-found} is -not specified, the default action will add @samp{-l@var{library}} to -@code{LIBS} and define @samp{HAVE_LIB@var{library}} (in all capitals). +with the library succeeds; @var{action-if-not-found} is a list of shell +commands to run if the link fails. If @var{action-if-found} is not +specified, the default action will prepend @samp{-l@var{library}} to +@code{LIBS} and define @samp{HAVE_LIB@var{library}} (in all +capitals). This macro is intended to support building of @code{LIBS} in +a right-to-left (least-dependent to most-dependent) fashion such that +library dependencies are satisfied as a natural side-effect of +consecutive tests. Some linkers are very sensitive to library ordering +so the order that @code{LIBS} is generated in is important to reliable +detection of libraries. If linking with @var{library} results in unresolved symbols, which would be resolved by linking with additional libraries, give those libraries as the @var{other-libraries} argument, separated by spaces: @samp{-lXt -lX11}. Otherwise this macro will fail to detect that @var{library} is present, because linking the test program will always fail with -unresolved symbols. +unresolved symbols. The @var{other-libraries} argument should be limited +to cases where it is desirable to test for the library in the presence of +another (which may not already be in @code{LIBS}). @end defmac @defmac AC_HAVE_LIBRARY (@var{library}, @r{[}, @var{action-if-found} @r{[}, @var{action-if-not-found} @r{[}, @var{other-libraries}@r{]]]}) diff --git a/doc/autoconf.texi b/doc/autoconf.texi index ce02ea1c..1eb6551c 100644 --- a/doc/autoconf.texi +++ b/doc/autoconf.texi @@ -8,7 +8,7 @@ @set EDITION 2.13 @set VERSION 2.13 -@set UPDATED December 1998 +@set UPDATED January 1999 @iftex @finalout @@ -27,7 +27,8 @@ This file documents the GNU Autoconf package for creating scripts to configure source code packages using templates and an @code{m4} macro package. -Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998 Free Software Foundation, Inc. +Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999 Free Software +Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -61,7 +62,8 @@ by the Foundation. @page @vskip 0pt plus 1filll -Copyright @copyright{} 1992, 93, 94, 95, 96, 98 Free Software Foundation, Inc. +Copyright @copyright{} 1992, 93, 94, 95, 96, 98, 99 Free Software +Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice @@ -1841,17 +1843,25 @@ name of the library; e.g., to check for @samp{-lmp}, use @samp{mp} as the @var{library} argument. @var{action-if-found} is a list of shell commands to run if the link -with the library succeeds; @var{action-if-not-found} is a list of -shell commands to run if the link fails. If @var{action-if-found} is -not specified, the default action will add @samp{-l@var{library}} to -@code{LIBS} and define @samp{HAVE_LIB@var{library}} (in all capitals). +with the library succeeds; @var{action-if-not-found} is a list of shell +commands to run if the link fails. If @var{action-if-found} is not +specified, the default action will prepend @samp{-l@var{library}} to +@code{LIBS} and define @samp{HAVE_LIB@var{library}} (in all +capitals). This macro is intended to support building of @code{LIBS} in +a right-to-left (least-dependent to most-dependent) fashion such that +library dependencies are satisfied as a natural side-effect of +consecutive tests. Some linkers are very sensitive to library ordering +so the order that @code{LIBS} is generated in is important to reliable +detection of libraries. If linking with @var{library} results in unresolved symbols, which would be resolved by linking with additional libraries, give those libraries as the @var{other-libraries} argument, separated by spaces: @samp{-lXt -lX11}. Otherwise this macro will fail to detect that @var{library} is present, because linking the test program will always fail with -unresolved symbols. +unresolved symbols. The @var{other-libraries} argument should be limited +to cases where it is desirable to test for the library in the presence of +another (which may not already be in @code{LIBS}). @end defmac @defmac AC_HAVE_LIBRARY (@var{library}, @r{[}, @var{action-if-found} @r{[}, @var{action-if-not-found} @r{[}, @var{other-libraries}@r{]]]})