FYI: document AM_PROG_CC_STDC is a relic, on branch-1-7

[Alexandre Duret-Lutz]

I'm checking this in on branch-1-7, to prepare people about the more
drastic change on HEAD.

2002-12-05  Alexandre Duret-Lutz  <address@hidden>

        * automake.texi (Public macros) <AM_PROG_CC_STDC>: Explain this
        macro is obsolete, and that users should
        s/am_cv_prog_cc_stdc/ac_cv_prog_cc_stdc/ their configure.ac.

Index: NEWS
===================================================================
RCS file: /cvs/automake/automake/NEWS,v
retrieving revision 1.198.2.14
diff -u -r1.198.2.14 NEWS
--- NEWS        4 Dec 2002 18:08:33 -0000       1.198.2.14
+++ NEWS        5 Dec 2002 09:29:03 -0000
@@ -21,6 +21,9 @@
   (but not all) shell metachars.
 * Fix the following spurious failures in the test suite:
   depcomp2.test, gnits2.test, gnits3.test, python3.test, texinfo13.test
+* Noteworthy manual updates:
+  - Augment the section about BUILT_SOURCES.
+  - Mention that AM_PROG_CC_STDC is a relic that is beter avoided today.
 
 Bugs fixed in 1.7.1:
 * Honor `ansi2knr' for files built in subdirectories, or using per-targets
Index: automake.texi
===================================================================
RCS file: /cvs/automake/automake/automake.texi,v
retrieving revision 1.305.2.7
diff -u -r1.305.2.7 automake.texi
--- automake.texi       4 Dec 2002 19:32:40 -0000       1.305.2.7
+++ automake.texi       5 Dec 2002 09:29:23 -0000
@@ -1644,6 +1644,15 @@
 code in ANSI C, you can make an un-ANSIfied copy of it by using the
 @code{ansi2knr} option (@pxref{ANSI}).
 
+This macro is a relic from the time Autoconf didn't offer such a
+feature.  @code{AM_PROG_CC_STDC}'s logic has now been merged into
+Autoconf's @code{AC_PROG_CC} macro, therefore you should use the latter
+instead.  Chances are you are already using @code{AC_PROG_CC}, so you
+can simply remove the @code{AM_PROG_CC_STDC} call and turn all
+occurrences of @code{$am_cv_prog_cc_stdc} into
address@hidden  @code{AM_PROG_CC_STDC} will be marked as
+obsolete (in the Autoconf sense) in Automake 1.8.
+
 @item AM_PROG_LEX
 @cindex HP-UX 10, lex problems
 @cindex lex problems with HP-UX 10

-- 
Alexandre Duret-Lutz