Re: AC_FOREACH public?

[Ralf Wildenhues]

Hi Keith,

* Keith MARSHALL wrote on Wed, Oct 19, 2005 at 02:23:27PM CEST:
> Ralf Wildenhues wrote:
> > Can I assume AC_FOREACH is a stable, public interface?

> Indeed, I've wondered about this too.
> 
> I've seen it used, (in groff's aclocal.m4), and have even used it myself.
> I assumed its omission from the docs was an oversight;  it would be good
> to see that rectified.

OK, here's a hacky patch to document both AU_ALIAS and AC_FOREACH.
I'm sure the latter ended up in the wrong section, but I could not
find a better one (a new one maybe?).

Cheers,
Ralf

        * doc/autoconf.texi (Redefined M4 Macros): Document AC_FOREACH.
        (Obsoleting Macros): Document AU_ALIAS.

Index: doc/autoconf.texi
===================================================================
RCS file: /cvsroot/autoconf/autoconf/doc/autoconf.texi,v
retrieving revision 1.929
diff -u -r1.929 autoconf.texi
--- doc/autoconf.texi   1 Sep 2005 13:49:02 -0000       1.929
+++ doc/autoconf.texi   19 Oct 2005 16:27:35 -0000
@@ -8917,6 +8917,12 @@
 $1 = [a],[b], $@@ = [[a],[b]]
 @end example
 
address@hidden AC_FOREACH (@var{variable}, @var{list}, @var{expression})
address@hidden
+Expand @var{expression} assigning each value of the @var{list} to
address@hidden  @var{list} should be a white-space separated list.
address@hidden defmac
+
 
 
 @node Forbidden Patterns
@@ -9480,7 +9486,7 @@
 macros.  Ideally, @command{autoupdate} should replace the old macro calls
 with their modern implementation.
 
-Autoconf provides a simple means to obsolete a macro.
+Autoconf provides two simple ways to obsolete a macro.
 
 @defmac AU_DEFUN (@var{old-macro}, @var{implementation}, @ovar{message})
 @auindex{DEFUN}
@@ -9493,6 +9499,14 @@
 include information on what to do after running @command{autoupdate};
 @command{autoupdate} will print it as a warning, and include it
 in the updated @file{configure.ac} file.
address@hidden defmac
+
address@hidden AU_ALIAS (@var{old-name}, @var{new-name})
address@hidden
+The @var{old-name} is no longer used, just use @var{new-macro} instead.
address@hidden([OLD], [NEW])} is roughly equivalent to
address@hidden([OLD], [NEW($@@)])}, but the number @code{$#} of arguments
+is not guaranteed to remain identical.
 @end defmac
 
 @node Coding Style