>> Slightly changing the example in the documentation illustrates this:
>>
>> c4 d
>> \override NoteHead #'color = #red
>> e4 f |
>> \once \override NoteHead #'color = #green
>> g4 a
>> \revert NoteHead #'color
>> b c |
>>
>> A single note is green, then we continue with red notes until we use \revert 
>> to
>> get the default color (black).
[...]
>
> Doesn't it already explain this in the section before (explaining the
> \revert command)?

Yes, the \revert command is properly explained.


My main concern is updating this sentence (after \once we go back to
the "current" value, not the default value):

>> [...] effective only during the current musical moment before the property
>> reverts back to its default value.
>>
>> It should say something like : "reverts back to its current value (this can 
>> be
>> different from the default if an \override is in effect)."


Changing the code example to have an \override in effect (red color)
would explicitly show this: after using \once we go back to (red
color), not to the context's default (black color).
In my opinion this doesn't overly complicate the manual, and might be
more clear.

_______________________________________________
bug-lilypond mailing list
bug-lilypond@gnu.org
https://lists.gnu.org/mailman/listinfo/bug-lilypond

Reply via email to