Re: Possible errors in the documentation

[Trevor Daniels]

Joram Berger wrote Tuesday, November 13, 2012 8:15 PM

> recently, I noticed some spots in the documentation, where I think that
> could be wrong – at least I don't understand why it is documented like that:
> 
> 1)
> http://lilypond.org/doc/v2.16/Documentation/notation/writing-rhythms#scaling-durations
> It is:
>  % Scale music by *2
> Should it be?
>  % Scale music by 1/2
> or
>  % Divide durations by 2

Assuming I've found the example you mean I don't see any error.  It says:

% Scale music by *2
\scaleDurations 2/1 {
  <c' a>4 c8 b
}

and this multiplies the durations of the following three notes by 2/1 , i.e, by 
2,
so the c8, for example, looks like an eighth note, but actually has a duration 
of
a quarter note, filling half the 2/4 measure.

> 2)
> http://lilypond.org/doc/v2.16/Documentation/notation/single-voice#chorded-notes
> in the last list, the first bullet:
> It is:
>  y f!
> Should it be?
>  s f!

I can't see what you mean.  The first bullet of the last list reads:

temporary use of Multiple voices, ‘<< f! \\ <e fis!> >>’, 

Where is the y f! ?

> 3) http://lilypond.org/doc/v2.16/Documentation/notation/multiple-voices.html
> It is:
>  This example maps _four consecutive measures_ to four variables
> Should it be?
>  four voices? (or 2 consecutive measures?)

This is a long section.  Where exactly is this?
Ah, found it - right at the bottom.
It is badly worded - it should be 
".. maps four voices in two consecutive measures to four variables."
 
[snip the errors in the German docs - I can't respond to those]
 
> Is there a better/preferred way than the developers list to bring up
> issues like that?

Well, the bug list might be better, but this has worked :)

Trevor