From: Paul Eggert <eggert@cs.ucla.edu>
Date: Thu, 31 Aug 2006 22:38:30 +0000 (+0000)
Subject: * NEWS: AC_FUNC_FNMATCH, AC_FUNC_FNMATCH_GNU, AC_FUNC_GETLOADVG,
X-Git-Tag: AUTOCONF-2.60b~61
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bc5477ae6d9dc13256815521a8a481cfc7ce32f8;p=thirdparty%2Fautoconf.git

* 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 a92070a50..30f785bac 100644
--- 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 c396bd04e..51320f4c1 100644
--- 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 5db693228..3906cde10 100644
--- 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