From: Bruno Haible <bruno@clisp.org>
Date: Fri, 17 Sep 2010 15:56:27 +0000 (-0600)
Subject: docs: mark several macros obsolete
X-Git-Tag: v2.68~10
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b99695da259535240b5f86ae8f073efd30786869;p=thirdparty%2Fautoconf.git

docs: mark several macros obsolete

* doc/autoconf.texi (Particular Functions): Mark AC_FUNC_ERROR_AT_LINE,
AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK, AC_FUNC_MKTIME, AC_FUNC_STRTOD
as obsolete and refer to Gnulib.
* NEWS: Mention the change.

Signed-off-by: Eric Blake <eblake@redhat.com>
---

diff --git a/ChangeLog b/ChangeLog
index f89b4126..82185b47 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2010-09-17  Bruno Haible  <bruno@clisp.org>
 
+	docs: mark several macros obsolete
+	* doc/autoconf.texi (Particular Functions): Mark AC_FUNC_ERROR_AT_LINE,
+	AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK, AC_FUNC_MKTIME, AC_FUNC_STRTOD
+	as obsolete and refer to Gnulib.
+	* NEWS: Mention the change.
+
 	AC_FUNC_STRNLEN: more realistic cross-compilation guess
 	* lib/autoconf/functions.m4 (AC_FUNC_STRNLEN): Require
 	AC_CANONICAL_HOST. When cross-compiling, guess it works everywhere
diff --git a/NEWS b/NEWS
index f24b94ca..65013c79 100644
--- a/NEWS
+++ b/NEWS
@@ -33,6 +33,15 @@ GNU Autoconf NEWS - User visible changes.
 
 ** AC_FC_LIBRARY_LDFLAGS now tolerates output from newer gfortran.
 
+** Newly obsolete macros
+   The following macros have been marked obsolete.  New programs
+   should use the corresponding Gnulib modules.  Gnulib not only
+   detects a larger set of portability problems with these functions,
+   but also provides complete workarounds.
+
+     AC_FUNC_ERROR_AT_LINE  AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
+     AC_FUNC_MKTIME  AC_FUNC_STRTOD
+
 
 * Major changes in Autoconf 2.67 (2010-07-21) [stable]
   Released by Eric Blake, based on git versions 2.66.*.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 84715259..64243029 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -4905,6 +4905,9 @@ If the @code{error_at_line} function is not found, require an
 
 The result of this macro is cached in the @code{ac_cv_lib_error_at_line}
 variable.
+
+The @code{AC_FUNC_ERROR_AT_LINE} macro is obsolescent.  New programs
+should use Gnulib's @code{error} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_FNMATCH
@@ -5146,6 +5149,9 @@ If @code{lstat} behaves properly, define
 
 The result of this macro is cached in the
 @code{ac_cv_func_lstat_dereferences_slashed_symlink} variable.
+
+The @code{AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK} macro is obsolescent.
+New programs should use Gnulib's @code{lstat} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_MALLOC
@@ -5235,6 +5241,9 @@ Posix standard and should be the inverse of
 
 The result of this macro is cached in the
 @code{ac_cv_func_working_mktime} variable.
+
+The @code{AC_FUNC_MKTIME} macro is obsolescent.  New programs should
+use Gnulib's @code{mktime} module.  @xref{Gnulib}.
 @end defmac
 
 @anchor{AC_FUNC_MMAP}
@@ -5414,6 +5423,9 @@ variable @code{POW_LIB} to the extra library needed.
 
 This macro caches its result in the @code{ac_cv_func_strtod} variable
 and depends upon the result in the @code{ac_cv_func_pow} variable.
+
+The @code{AC_FUNC_STRTOD} macro is obsolescent.  New programs should
+use Gnulib's @code{strtod} module.  @xref{Gnulib}.
 @end defmac
 
 @defmac AC_FUNC_STRTOLD