AS_HELP_STRING quoting? (doc bug)

[Stepan Kasal]

Hello,
        the autoconf manual says:

: AC_ARG_WITH([foo],
:       AS_HELP_STRING([--with-foo], [use foo (default is NO)]))
:
: Please note that the call to `AS_HELP_STRING' is *unquoted*.

Well, this sentence is somewhat misleading.
The whole call AS_HELP_STRING(...) can be quoted.
It cannot be enclosed in double brackets, of course: it's not a literal
string.

The important thing is that the description is not a literal string,
thus you may not quote it in double brackets.

So the following two examples work perfectly:

AC_ARG_ENABLE(border-size,
        [AS_HELP_STRING(--enable-border-size=n,
                [Set default border size to `n'.])])

AC_ARG_ENABLE([[border-size]],
        [AS_HELP_STRING([[--enable-border-size=n]],
                [Set default border size to `n'.])])

There is a similar issue with AC_DEFINE and perhaps others:
The description text cannot be double-quoted, as it is not a literal
string; it'll be reformatted.  So you cannot do:

        AC_DEFINE(X, 007, [[Default border size.]])

you have to do:

        AC_DEFINE(X, 007, [Default border size.])

I think this could be explained better in the manual.

I'm not absolutely sure, so I don't offer a patch at this stage.

Thank you for the whole autoconf work, and especially for the manual,
which is a very useful resource.

Yours,
        Stepan Kasal