RE: Documentation - first impressions of the latest manual

[Anthony Youngman]

Suggested rewrite for 6.4.4 Partial measures


The syntax for this command is 

\partial duration

Where duration is the length of the leading notes.

This is internally translated into 

\set Timing.measurePosition = -length of duration

Where the property measurePosition contains a negative number counting
backwards from the first barline.


(Original text cut-n-pasted from the web site, so it was the latest)
Cheers,
Wol


-----Original Message-----
From:
address@hidden
[mailto:address@hidden
u.org] On Behalf Of Anthony Youngman
Sent: 19 June 2006 16:08
To: lily-devel
Subject: Documentation - first impressions of the latest manual

Note I'm working from the pdf version...

2.13 Printing Lyrics

Your hyphen example leads me to believe the text under the notes should
read "Twin-kle twin-kle". There are no hyphens but it looks to me as if
the whole point of the example is "how to put hyphens in".

4.1 Suggestions for writing Lilypond files

A new one that I've found you don't want to forget - "explicitly specify
the length of the first note every time you use '{'. Don't rely on the
default".

The number of times I've stuck music expressions together, and because I
forgot that, the first note of the second expression takes its length
from the last note of the first, and gets it badly wrong...

6.4.4 Partial measures

imho this is still very misleading at first glance. It should be
something like

"The syntax for this command is
        \partial duration
where duration is the length of the leading notes

Part of the trouble is the last sentence - "The property measurePosition
contains a rational number indicating how much of the measure has passed
at this point." Which measure? The one you think you're in, or the one
the computer thinks you're in? My instinctive reaction is "the partial
measure" but with hindsight that clearly is wrong. You're talking about
the first full measure, which is not the measure containing the leading
notes... if you change this sentence to say "the first full measure" at
least it's a bit clearer (but still weird to a musician - "at the start
of the piece our positon relative to the second bar is ...").

6.4.6 Unmetered music

In the "bugs" section you seem slightly confused, mentioning first page
breaks, then line breaks. Which one is it?


I'll call it a day here, and carry on with chapter 9 tomorrow ...

Cheers,
Wol


*
************************************************************************
*

This transmission is intended for the named recipient only. It may
contain private and confidential information. If this has come to you in
error you must not act on anything disclosed in it, nor must you copy
it, modify it, disseminate it in any way, or show it to anyone. Please
e-mail the sender to inform us of the transmission error or telephone
ECA International immediately and delete the e-mail from your
information system.

Telephone numbers for ECA International offices are: Sydney +61 (0)2
8272 5300, Hong Kong + 852 2121 2388, London +44 (0)20 7351 5000 and New
York +1 212 582 2333.

*
************************************************************************
*


_______________________________________________
lilypond-devel mailing list
address@hidden
http://lists.gnu.org/mailman/listinfo/lilypond-devel

* ************************************************************************ *

This transmission is intended for the named recipient only. It may contain 
private and confidential information. If this has come to you in error you must 
not act on anything disclosed in it, nor must you copy it, modify it, 
disseminate it in any way, or show it to anyone. Please e-mail the sender to 
inform us of the transmission error or telephone ECA International immediately 
and delete the e-mail from your information system.

Telephone numbers for ECA International offices are: Sydney +61 (0)2 8272 5300, 
Hong Kong + 852 2121 2388, London +44 (0)20 7351 5000 and New York +1 212 582 
2333.

* ************************************************************************ *