add advice

diff --git a/autoconf.texi b/autoconf.texi
index 6eae404fca27618c03886f60256bf9fd55382c04..362ffe75db401f43cc615dd17b11bdd6bd67833c 100644 (file)
--- a/autoconf.texi
+++ b/autoconf.texi
@@ -3766,6 +3766,11 @@ When defining your own macros, you may now use @code{AC_DEFUN} instead of
 @code{AC_PROVIDE}.  There's no harm in continuing to use the older way;
 it's just less convenient.  @xref{Macro Format}.
 
+You probably looked at the macros that came with Autoconf as a guide for
+how to do things.  It would be a good idea to take a look at the new
+versions of them, as the style is somewhat improved and they take
+advantage of some new features.
+
 If you were doing tricky things with undocumented Autoconf internals
 (diversions, macros, variables), check whether you need to change
 anything to account for changes that have been made.  Perhaps you can

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 6eae404fca27618c03886f60256bf9fd55382c04..362ffe75db401f43cc615dd17b11bdd6bd67833c 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -3766,6 +3766,11 @@ When defining your own macros, you may now use @code{AC_DEFUN} instead of
 @code{AC_PROVIDE}.  There's no harm in continuing to use the older way;
 it's just less convenient.  @xref{Macro Format}.
 
+You probably looked at the macros that came with Autoconf as a guide for
+how to do things.  It would be a good idea to take a look at the new
+versions of them, as the style is somewhat improved and they take
+advantage of some new features.
+
 If you were doing tricky things with undocumented Autoconf internals
 (diversions, macros, variables), check whether you need to change
 anything to account for changes that have been made.  Perhaps you can