libtool-patches
[Top][All Lists]
Advanced

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

Re: Clean up @var handling in the manual.


From: Peter O'Gorman
Subject: Re: Clean up @var handling in the manual.
Date: Sat, 19 Jun 2010 08:44:44 -0500
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1.9) Gecko/20100430 Fedora/3.0.4-3.fc13 Thunderbird/3.0.4

On 06/19/2010 03:15 AM, Ralf Wildenhues wrote:
In texinfo, @var is for metasyntactic variables only, that is, things
that stand for other things *in the manual*.  If you need a guideline,
then @var is only appropriate if you can replace the name with some
other name, say, the mathematician's favorite, x (or x1, x2, x3 ...)
and that replacement does not change the meaning of the text.  Along
the same tangent, it does not make sense to mention some @var that is
not defined anywhere, e.g., as argument in a function declaration.

With that in mind, the patch below cleans up the Libtool manual, and
follows the Texinfo manual's recommendation of using lower-case @var.

OK to commit?

Sure.

Peter




reply via email to

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