Re: Doc: expand explanation of negative measurePosition (3080) (issue 8538050)

[tdanielsmusic]

Reviewers: Graham Percival, Jean-Charles,

Message:
Thanks for the review!


https://codereview.appspot.com/8538050/diff/1/Documentation/notation/rhythms.itely
File Documentation/notation/rhythms.itely (right):

https://codereview.appspot.com/8538050/diff/1/Documentation/notation/rhythms.itely#newcode1422
Documentation/notation/rhythms.itely:1422: is usually positive and
indicates how much of the measure has passed
On 2013/04/21 09:25:49, Jean-Charles wrote:
> Sorry, but "minus 1/8" seems to me to be a negative value?

It is indeed!  But measurePosition is _usually_ positive.
It is only negative when manually set so by \partial.  Is
the following sentence not clear enough?

Description:
Doc: expand explanation of negative measurePosition (3080)

  based on text provided by Federico Bruni

Please review this at https://codereview.appspot.com/8538050/

Affected files:
  M Documentation/notation/rhythms.itely


Index: Documentation/notation/rhythms.itely
diff --git a/Documentation/notation/rhythms.itely  
b/Documentation/notation/rhythms.itely
index  
cc69b76764a820681c9c64d48621526d197d949b..cf55675ec39b034f33028026dff5627eb2b8cbcc  
100644
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -1404,13 +1404,13 @@ The @var{duration} can be any value less than a  
full measure:
 r4 e8 | a4 c8 b c4 |
 @end lilypond

-The @code{\partial @var{duration}} can also be written as;
address@hidden @var{duration}} can also be written as:

 @example
 \set Timing.measurePosition address@hidden
 @end example

-So @code{\partial 8} becomes:
+So the first example above could be written:

 @lilypond[quote,verbatim,relative=1]
 \time 3/4
@@ -1418,11 +1418,12 @@ So @code{\partial 8} becomes:
 e8 | a4 c8 b c4 |
 @end lilypond

-The property @code{measurePosition} contains a rational number
-indicating how much of the measure has passed at this point.  Note
-that this is set to a negative number by the @code{\partial} command:
-i.e., @code{\partial 4} is internally translated to @address@hidden,
-meaning @qq{there is a quarter note left in the measure.}
+The property @code{measurePosition} contains a rational number, which
+is usually positive and indicates how much of the measure has passed
+at this point.  The @code{\partial @var{duration}} command sets it to
+a negative number, when it has a different meaning: it then says that
+the current (first) bar will be @emph{preceded} by a bar 0 (the partial
+bar) with a duration given by @var{duration}.

 @seealso
 Music Glossary: