Hello Eric,
* Eric Blake wrote on Tue, Mar 02, 2010 at 01:32:24AM CET:
> From 22d46ebe6ddaeb128e2b4119add59dccecc28526 Mon Sep 17 00:00:00 2001
> From: Eric Blake <[email protected]>
> Date: Mon, 1 Mar 2010 17:17:40 -0700
> Subject: [PATCH 1/3] Optimize AS_BOX.
>
> * lib/m4sugar/m4sh.m4 (AS_BOX): Use less m4 time.
> (_AS_BOX_LITERAL): Use fewer forks in the common case.
> * doc/autoconf.texi (Common Shell Constructs) <AS_BOX>: Document
> the macro.
> * NEWS: Mention it.
this hasn't been committed yet, and ...
> --- a/doc/autoconf.texi
> +++ b/doc/autoconf.texi
> @@ -13047,6 +13047,17 @@ Common Shell Constructs
> @end defmac
> @end ignore
>
> +...@defmac AS_BOX (@var{text}, @var{char, -})
... the last @var should be @dvar.
> +...@asindex{box}
> +Expand into shell code that will output @var{text} surrounded by a box
> +with @var{char} in the top and bottom border. @var{text} should not
> +contain a newline, but may contain shell expansions valid for unquoted
> +here-documents. @var{char} defaults to @samp{-}, but can be any
> +character except @samp{/}, @samp{'}, @samp{"}, @samp{\}, @samp{$},
> +...@samp{&}, or @samp{`}. This is useful for outputting a comment box into
> +log files to separate distinct phases of script operation.
> +...@end defmac
[...]
Cheers,
Ralf
