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 f89b412650a82d04e33aa113a239b3a30c59c123..82185b4741ce762f83eeebc5e3008a2d710eb30b 100644 (file)
--- 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 f24b94ca41049106e3aebcfd20ac5e892def1f66..65013c79aa9a1547c60ed0ff039650318ea31d1f 100644 (file)
--- 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 8471525923652cace355d1abbe09dac5aa6dc265..642430299837aace6349c29d14fb8523b5c3fe3e 100644 (file)
--- 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