Doc touchups.

* doc/autoconf.texi (Text processing Macros) <m4_strip>
<m4_text_wrap>: Clarify and fix typos.

Signed-off-by: Eric Blake <ebb9@byu.net>
This commit is contained in:
Eric Blake 2007-10-19 05:11:51 -06:00
parent 32d3effc40
commit 253253d3a9
2 changed files with 21 additions and 10 deletions

View File

@ -1,3 +1,9 @@
2007-10-19 Eric Blake <ebb9@byu.net>
Doc touchups.
* doc/autoconf.texi (Text processing Macros) <m4_strip>
<m4_text_wrap>: Clarify and fix typos.
2007-10-18 Eric Blake <ebb9@byu.net> 2007-10-18 Eric Blake <ebb9@byu.net>
Ignore `make dist' changelogs in testsuite.log. Ignore `make dist' changelogs in testsuite.log.

View File

@ -11040,9 +11040,11 @@ If @var{string} is empty, the result is an empty list.
@defmac m4_strip (@var{string}) @defmac m4_strip (@var{string})
@msindex{strip} @msindex{strip}
Strip whitespace from @var{string}. Sequences of space and tab are Strip whitespace from @var{string}. Sequences of spaces and tabs are
reduced to a single space, then leading and trailing spaces are reduced to a single space, then leading and trailing spaces are removed.
removed. The result is still a quoted string. 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}.
@end defmac @end defmac
@defmac m4_text_box (@var{message}, @dvar{frame, -}) @defmac m4_text_box (@var{message}, @dvar{frame, -})
@ -11063,13 +11065,16 @@ m4_text_box([macro])
@dvar{prefix1, @var{prefix}}, @dvar{width, 79}) @dvar{prefix1, @var{prefix}}, @dvar{width, 79})
@msindex{text_wrap} @msindex{text_wrap}
Break @var{string} into a series of whitespace-separated words, then Break @var{string} into a series of whitespace-separated words, then
format those words to wrap within @var{width} columns, and without output those words separated by spaces, and wrapping lines any time the
trailing whitespace. If given, @var{prefix1} is prepended to the first output would exceed @var{width} columns. If given, @var{prefix1} begins
line, and @var{prefix} is prepended to each continuation line. As a the first line, and @var{prefix} begins all wrapped lines. If
special case, if @var{prefix1} is longer than @var{prefix}, the first @var{prefix1} is longer than @var{prefix}, then the first line consists
line will consist solely of @var{prefix1}. No expansions occur on of just @var{prefix1}. If @var{prefix} is longer than @var{prefix1},
@var{prefix}, @var{prefix1}, or the words of @var{string}, although padding is inserted so that the first word of @var{string} begins at the
quadrigraphs are recognized. same indentation as all wrapped lines. Note that using literal tab
characters in any of the arguments will interfere with the calculation
of width. No expansions occur on @var{prefix}, @var{prefix1}, or the
words of @var{string}, although quadrigraphs are recognized.
For some examples: For some examples:
@example @example