Re: [PATCH]: Doc: LM 3.2: Entering voices in the correct order.

[Graham Percival]

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