Re: Docs bug: \once prefix

[James]

Hello,

On 1 January 2012 12:02,  <address@hidden> wrote:
>>> 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.

http://code.google.com/p/lilypond/issues/detail?id=2164&thanks=2164

Patch uploaded for review.

Thanks

-- 
--

James