[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Fix #888: Add ly:stencil-scale. (issue2275042)
From: |
Carl . D . Sorensen |
Subject: |
Re: Fix #888: Add ly:stencil-scale. (issue2275042) |
Date: |
Wed, 27 Oct 2010 18:39:30 +0000 |
On 2010/10/26 08:21:41, Mark Polesky wrote:
Well... Okay, yeah, but see this:
http://kainhofer.com/%7Elilypond/Documentation/contributor/syntax-survey.html#miscellany
I'm the one that wrote the @var description there. And yes,
the rationale is simplistic: "This improves readability in
the PDF and HTML output." But I think Neil's impulse to
format it that way matches the spirit of the rationale, no?
And I certainly wouldn't be opposed to instituting the same
policy for A.17, though of course that would be best left
for a different patch than this one.
I think that wrapping a variable declaration in a code declaration is
undesirable. It complicates the format of the documentation, for very
little benefit (if any).
If we want to change the format of @var{} in HTML and PDF format, we
ought to be able to do that in our texinfo program.
Or alternatively, we should get a different texinfo macro, e.g. @var{}
for outside of code, and @codevar{} for use inside of code.
THanks,
Carl
http://codereview.appspot.com/2275042/
- Fix #888: Add ly:stencil-scale. (issue2275042), v . villenave, 2010/10/04
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), pnorcks, 2010/10/08
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), n . puttock, 2010/10/24
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), n . puttock, 2010/10/24
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), pnorcks, 2010/10/25
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), lemzwerg, 2010/10/25
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), n . puttock, 2010/10/25
- Re: Fix #888: Add ly:stencil-scale. (issue2275042), markpolesky, 2010/10/26
- Re: Fix #888: Add ly:stencil-scale. (issue2275042),
Carl . D . Sorensen <=