[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

AS_HELP_STRING quoting? (doc bug)

From: Stepan Kasal
Subject: AS_HELP_STRING quoting? (doc bug)
Date: Thu, 21 Oct 2004 09:44:03 +0200
User-agent: Mutt/1.4.1i

        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

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:

                [Set default border size to `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.

        Stepan Kasal

reply via email to

[Prev in Thread] Current Thread [Next in Thread]