Re: Doc: LM adjusted explanation for \once (issue 5489129)

[pkx166h]

Reviewers: janek,

Message:
Thanks Janek.


http://codereview.appspot.com/5489129/diff/1/Documentation/learning/tweaks.itely
File Documentation/learning/tweaks.itely (right):

http://codereview.appspot.com/5489129/diff/1/Documentation/learning/tweaks.itely#newcode284
Documentation/learning/tweaks.itely:284: moment before the property
reverts back to its current value (this can
On 2012/01/01 12:26:22, janek wrote:
> i think that "reverts back to its previous value" might be less
confusing.

Done.

Description:
Doc: LM adjusted explanation for \once

This is for Tracker issue 2164

As suggested by email on lilypond-user

Updated example and text to show that after using \once, the
'revert' does not necessarily go back to the 'default' value
as originally stated, if another \override is
still in place.

Please review this at http://codereview.appspot.com/5489129/

Affected files:
  M Documentation/learning/tweaks.itely


Index: Documentation/learning/tweaks.itely
diff --git a/Documentation/learning/tweaks.itely  
b/Documentation/learning/tweaks.itely
index  
6e6f73321024a92b16374d343c5ad84042c519d4..d8903d9129c3c1f4d9c7443257eeba53ff58eb01  
100644
--- a/Documentation/learning/tweaks.itely
+++ b/Documentation/learning/tweaks.itely
@@ -278,22 +278,25 @@ b4 c |
 @funindex \once
 @funindex once

-Both the @code{\override} and the @code{\set} commands may be
-prefixed by @code{\once}.  This causes the following
address@hidden or @code{\set} command to be effective only
-during the current musical moment before the property reverts
-back to its default value.  Using the same example, we can
-change the color of a single note like this:
+Both the @code{\override} and the @code{\set} commands may be prefixed
+by @code{\once}.  This causes the following @code{\override} or
address@hidden command to be effective only during the current musical
+moment before the property reverts back to its previous value (this can
+be different from the default if another @code{\override} is still in
+effect).  Using the same example, we can change the color of a single
+note like this:

 @cindex color property, example
 @cindex NoteHead, example of overriding

 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 c4 d
-\once \override NoteHead #'color = #red
+\override NoteHead #'color = #red
 e4 f |
 \once \override NoteHead #'color = #green
-g4 a b c |
+g4 a
+\revert NoteHead #'color
+b c |
 @end lilypond

 @strong{\overrideProperty command}