doc: mention ACLOCAL_AMFLAGS and #

* doc/autoconf.texi: Mention that ACLOCAL_AMFLAGS
cannot use makefile comments.  Problem reported by
Collin Funk in:
https://lists.gnu.org/r/bug-gnulib/2024-06/msg00005.html

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index cb148398e31ab8113ac51829b723f8313fda0f52..ee3f2f7a4730384bef6650642363450d677052a8 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -1821,7 +1821,8 @@ If you want @command{autoreconf} to pass flags that are not listed here
 on to @command{aclocal}, set @code{ACLOCAL_AMFLAGS} in your @file{Makefile.am}.
 Due to a limitation in the Autoconf implementation these flags currently
 must be set on a single line in @file{Makefile.am}, without any
-backslash-newlines.  Also, be aware that future Automake releases might
+backslash-newlines or makefile comments.
+Also, be aware that future Automake releases might
 start flagging @code{ACLOCAL_AMFLAGS} as obsolescent, or even remove
 support for it.
 
@@ -2171,7 +2172,7 @@ Note that if you use @command{aclocal} from an Automake release prior to
 in your top-level @file{Makefile.am}.  Due to a limitation in
 the Autoconf implementation of @command{autoreconf}, these include
 directives currently must be set on a single line in @file{Makefile.am},
-without any backslash-newlines.
+without any backslash-newlines or makefile comments.
 @end defmac
 
 @prindex @command{config.guess}