[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH]: Doc: LM 3.2: Entering voices in the correct order.
From: |
Graham Percival |
Subject: |
Re: [PATCH]: Doc: LM 3.2: Entering voices in the correct order. |
Date: |
Sun, 19 Sep 2010 19:32:48 +0100 |
User-agent: |
Mutt/1.5.20 (2009-06-14) |
On Sat, Sep 18, 2010 at 06:59:13PM -0700, Mark Polesky wrote:
> Graham Percival wrote:
> > - I don't like the @example; could you use @enumerate
> > instead?
>
> I agree with Trevor; that would add extra space.
> > ... actually, do we really need the @example (or
> > @enumerate) ? The image looks great. What about removing
> > the @example entirely?
>
> I was thinking of our visually-impaired users.
That's a good point -- but OTOH, support for visually-impared
users is precisely why we heavily discourage non-verbatim
@lilypond. I think this stuff can be done nicely while keeping to
the general doc policies. What about something like this:
----- (untested code, and didn't think about the pitches)
When entering multiple voices, always put the highest voice first
and the lowest voice second. Additional voices should alternate
between next-highest and next-lowest:
@lilypond[blah]
\new Staff <<
{ b'2 } % 1: highest voice
\\
{ g,2 } % 2: lowest voice
\\
{ g'2 } % 3: second-highest
\\
{ d2 } % 4: second-lowest voice
\\
{ b'2 } % 5: third-highest voice
\\
{ b2 } % 5: third-lowest voice
>>
@end[lilypond]
-----
You could then go into the long verbatim-less @lilypond that shows
these with fingers.
Could you stick the next version of this patch on Reitveld ? I
think there's enough interest, and enough opinions on it, that
this would be worthwhile.
Cheers,
- Graham