* NEWS: AC_FUNC_FNMATCH, AC_FUNC_FNMATCH_GNU, AC_FUNC_GETLOADVG,

and AC_REPLACE_FNMATCH are now obsolescent in Autoconf.  New
programs should use their Gnulib counterparts.
* doc/autoconf.texi (Particular Functions): Likewise.
(Macro Names, testsuite Invocation): Replace uses of these
obsolete macros with uses of non-obsolete macros.

diff --git a/ChangeLog b/ChangeLog
index a92070a5082db20390293d84b50f660398820101..30f785bac655afa10785561155fa28a965aba85d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2006-08-31  Paul Eggert  <eggert@cs.ucla.edu>
+
+       * NEWS: AC_FUNC_FNMATCH, AC_FUNC_FNMATCH_GNU, AC_FUNC_GETLOADVG,
+       and AC_REPLACE_FNMATCH are now obsolescent in Autoconf.  New
+       programs should use their Gnulib counterparts.
+       * doc/autoconf.texi (Particular Functions): Likewise.
+       (Macro Names, testsuite Invocation): Replace uses of these
+       obsolete macros with uses of non-obsolete macros.
+
 2006-08-29  Eric Blake  <ebb9@byu.net>
 
        * configure.ac (AC_INIT): Bump to 2.60b.

diff --git a/NEWS b/NEWS
index c396bd04e42029fa67fd37e5409a7b46b67e7eb6..51320f4c15c447c2bcb37b4331ffe9ba9f85fcfd 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,14 @@
 * Major changes in Autoconf 2.60b (??)
 
+** Obsolescent macros
+  The documentation now says that the following macros are obsolescent,
+  as they are superseded by Gnulib:
+
+    AC_FUNC_FNMATCH  AC_FUNC_FNMATCH_GNU  AC_FUNC_GETLOADVG  AC_REPLACE_FNMATCH
+
+  New programs should use the Gnulib counterparts of these macros.
+  We have no current plans to remove them from Autoconf.
+
 * Major changes in Autoconf 2.60a (2006-08-25)
 
 ** GNU M4 1.4.6 or later is now recommended.  At least one "make check"

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 5db693228504ec74d92ca8527f29794bdf1b9d42..3906cde10af7551d0b27c884e2493f1885352eaf 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -4419,6 +4419,9 @@ Unlike the other specific
 @code{AC_FUNC} macros, @code{AC_FUNC_FNMATCH} does not replace a
 broken/missing @code{fnmatch}.  This is for historical reasons.
 See @code{AC_REPLACE_FNMATCH} below.
+
+This macro is obsolescent.  New programs should use Gnulib's
+@code{fnmatch-posix} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_FNMATCH_GNU
@@ -4429,6 +4432,9 @@ Behave like @code{AC_REPLACE_FNMATCH} (@emph{replace}) but also test
 whether @code{fnmatch} supports @acronym{GNU} extensions.  Detect common
 implementation bugs, for example, the bugs in the @acronym{GNU} C
 Library 2.1.
+
+This macro is obsolescent.  New programs should use Gnulib's
+@code{fnmatch-gnu} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_FORK
@@ -4547,6 +4553,9 @@ to @samp{true} (and otherwise to @samp{false}), and set
 @code{KMEM_GROUP} to the name of the group that should own the installed
 program.
 @end enumerate
+
+The @code{AC_FUNC_GETLOADVG} macro is obsolescent.  New programs should
+use Gnulib's @code{getloadavg} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_GETMNTENT
@@ -4891,6 +4900,10 @@ copy of the source code of @acronym{GNU} @code{fnmatch}.  If necessary,
 this source code is compiled as an @code{AC_LIBOBJ} replacement, and the
 @file{fnmatch_.h} file is linked to @file{fnmatch.h} so that it can be
 included in place of the system @code{<fnmatch.h>}.
+
+This macro is obsolescent, as it assumes the use of particular source
+files.  New programs should use Gnulib's @code{fnmatch-posix} module,
+which provides this macro along with the source files.  @xref{Gnulib}.
 @end defmac
 
 
@@ -10305,8 +10318,8 @@ C variables in libraries.
 
 After the category comes the name of the particular feature being
 tested.  Any further words in the macro name indicate particular aspects
-of the feature.  For example, @code{AC_FUNC_FNMATCH_GNU} checks whether
-the @code{fnmatch} function supports @acronym{GNU} extensions.
+of the feature.  For example, @code{AC_PROG_CC_STDC} checks whether the
+C compiler supports @acronym{ISO} Standard C.
 
 An internal macro should have a name that starts with an underscore;
 Autoconf internals should therefore start with @samp{_AC_}.
@@ -18120,7 +18133,7 @@ For example, running
 
 @noindent
 selects all tests tagged @samp{autoupdate} @emph{and} with tags
-containing @samp{FUNC} (as in @samp{AC_CHECK_FUNC}, @samp{AC_FUNC_FNMATCH},
+containing @samp{FUNC} (as in @samp{AC_CHECK_FUNC}, @samp{AC_FUNC_ALLOCA},
 etc.), while
 
 @example