@var just became @mvar in the texinfo documentation
Subject: @var just became @mvar in the texinfo documentation
From: Rupert Swarbrick
Date: Thu, 25 Apr 2013 15:08:12 +0100
To make the info documentation compile correctly with Texinfo 5, I went
through and fixed all the warnings we were getting. The first one that
crops up is actually a bit of a problem: basically, we were defining
@var to surround its argument with "<" and ">". All very well, but
Texinfo all ready has a meaning for @var.
There were two obvious ways to find a solution. Firstly, we could try to
undefine Texinfo's definition of @var. I'm not sure I have the
Texinfo-fu to do that correctly. Another option is to rename the thing
we've been using to something like @mvar{}. Which is what I did.
There's a terrifyingly large commit which switches over to the new
name. I did the renaming with the command:
sed -i 's/@var{/@mvar{/g' $(fgrep -lr '@var')
Not particularly clever, but everything seems to work afterwards.
So basically, I thought I'd better send a message to tell anyone writing
documentation that they want @mvar instead of @var now. If you really
hate the extra character, we can always try the first approach I
mentioned above and revert this commit again.
Rupert
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 315 bytes
Desc: not available
URL: <http://www.math.utexas.edu/pipermail/maxima/attachments/20130425/3ef60ce7/attachment.pgp>