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
_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel
