[Top][All Lists]

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

Re: Minor documentation nitpick

From: Graham Percival
Subject: Re: Minor documentation nitpick
Date: Sun, 12 Feb 2012 12:54:37 +0000
User-agent: Mutt/1.5.21 (2010-09-15)

On Sun, Feb 12, 2012 at 12:47:36PM -0000, Phil Holmes wrote:
> Automatic footnotes take three arguments; the @var{Layout Object} to be
> annotated, the @var{(x . y)} position of the indicator and a
> The texinfo manual says:
> "Use the @var command to indicate metasyntactic variables" and so it
> doesn't like the parentheses, since I assume a parenthesis cannot be
> part of a variable name.

aha, that's where it comes from!  this has been bugging me for 7
or 8 years.

> Ignore, replace the @var with @code, or what?

Let's make it a

@c weird construct to avoid complaint about parentheses ()
@c inside @var
annotated, the @address@hidden(x . y)}} position of the indicator and a

IIRC @var{} is displayed as @address@hidden  I don't like using
formatting commands directly, but let's do it anyway.

(oh, it might be nice to send a feature request to the texinfo
guys... but it's been years and years since they last had a
release, so let's use the workaround)

- Graham

reply via email to

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