Add cross-reference to new macros.

* doc/autoconf.texi (Text processing Macros) <m4_normalize>
<m4_strip>: Reference the new m4_ifblank.
Suggested by Mike Frysinger.

Signed-off-by: Eric Blake <ebb9@byu.net>

diff --git a/ChangeLog b/ChangeLog
index be0c8689e21abe7852d192570c74d86aa6cb2289..efa5501e9edbf62243bf1fac235832a6323380ee 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2009-04-13  Eric Blake  <ebb9@byu.net>
 
+       Add cross-reference to new macros.
+       * doc/autoconf.texi (Text processing Macros) <m4_normalize>
+       <m4_strip>: Reference the new m4_ifblank.
+       Suggested by Mike Frysinger.
+
        Make AS_IF, AS_CASE, and AS_FOR more robust to blank arguments.
        * lib/m4sugar/m4sh.m4 (_AS_CASE, _AS_CASE_DEFAULT, AS_FOR, _AS_IF)
        (_AS_IF_ELSE, AS_IF): Avoid syntax error on blank argument,

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index fc4d6188340264d1527fe91034e7c28e773a2c62..35cf745ac38b4fb58081df6e066981719e8c0a26 100644 (file)
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -11811,7 +11811,9 @@ that M4 does not discard leading whitespace during argument collection.
 Remove leading and trailing spaces and tabs, sequences of
 backslash-then-newline, and replace multiple spaces, tabs, and newlines
 with a single space.  This is a combination of @code{m4_flatten} and
-@code{m4_strip}.
+@code{m4_strip}.  To determine if @var{string} consists only of bytes
+that would be removed by @code{m4_normalize}, you can use
+@code{m4_ifblank}.
 @end defmac
 
 @defmac m4_re_escape (@var{string})
@@ -11834,7 +11836,8 @@ Strip whitespace from @var{string}.  Sequences of spaces and tabs are
 reduced to a single space, then leading and trailing spaces are removed.
 The result is still a quoted string.  Note that this does not interfere
 with newlines; if you want newlines stripped as well, consider
-@code{m4_flatten}, or do it all at once with @code{m4_normalize}.
+@code{m4_flatten}, or do it all at once with @code{m4_normalize}.  To
+quickly test if @var{string} has only whitespace, use @code{m4_ifblank}.
 @end defmac
 
 @defmac m4_text_box (@var{message}, @dvar{frame, -})