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
+@defmac AC_FOREACH (@var{variable}, @var{list}, @var{expression})
+@acindex{FOREACH}
+Expand @var{expression} assigning each value of the @var{list} to
+@var{variable}. @var{list} should be a white-space separated list.
+@end 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.
+@end defmac
+
+@defmac AU_ALIAS (@var{old-name}, @var{new-name})
+@auindex{ALIAS}
+The @var{old-name} is no longer used, just use @var{new-macro} instead.
+@code{AU_ALIAS([OLD], [NEW])} is roughly equivalent to
+@code{AU_DEFUN([OLD], [NEW($@@)])}, but the number @code{$#} of arguments
+is not guaranteed to remain identical.
@end defmac
@node Coding Style
_______________________________________________
Autoconf mailing list
Autoconf@xxxxxxx
http://lists.gnu.org/mailman/listinfo/autoconf
