1999-01-09 Ben Elliston <bje@cygnus.com>

        * autoconf.texi (AC_CHECK_LIB): Explain more. Contributed by Bob
        Friesenhahn <bfriesen@simple.dallas.tx.us>.
        (UPDATED): Bump to 1999.

diff --git a/ChangeLog b/ChangeLog
index 2939bebb178db41a51d9ab3f60f0ddec5ddc7a87..3902c1915596238fb29fbcf32b4427245eeb9b98 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 1999-01-09  Ben Elliston  <bje@cygnus.com>
 
+       * autoconf.texi (AC_CHECK_LIB): Explain more. Contributed by Bob
+       Friesenhahn <bfriesen@simple.dallas.tx.us>.
+       (UPDATED): Bump to 1999.
+
        * config.guess: Distinguish between OpenStep and NeXTStep
        platforms. Contributed by Wilfredo Sanchez <wsanchez@apple.com>.
 

diff --git a/autoconf.texi b/autoconf.texi
index ce02ea1c6192232d5886305667f4ef0e8a65df42..1eb6551c92e759ebaf205209dc177c812ff2b231 100644 (file)
--- 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 ce02ea1c6192232d5886305667f4ef0e8a65df42..1eb6551c92e759ebaf205209dc177c812ff2b231 100644 (file)
--- 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{]]]})