Re: Some documentation issues
Werner LEMBERG <[email protected]> Tue, 30 Sep 2025 09:14:10 +0000
| Newsgroups | gmane.comp.gnu.lilypond.bugs |
|---|---|
| Message-ID | <[email protected]> |
>>> - In Learning Manual > 5.4.2 Within-staff objects > The direction
>>> property, in the list of predefined \objectDown \objectUp
>>> \objectNeutral commands, every command in the “Revert” column is
>>> \*Neutral, except for the command for arpeggio arrows, which is
>>> \arpeggioNormal. Please change it to \arpeggioArrowNeutral to
>>> match every other command.
>
>> Well, `\arpeggioArrowNeutral` doesn't make any sense! There are no
>> arrows in the 'neutral' case.
>
>>> Additionally, it might be best to change the \arpeggioArrowDown
>>> and \arpeggioArrowUp commands to simply \arpeggioDown and
>>> \arpeggioUp respectively, in which case the reverting command
>>> should become \arpeggioNeutral to match them
>
>> Carl Sorensen has changed this from `\arpeggioDown` to
>> `\arpeggioArrowDown`, in version 2.11.51 (from 2008). Carl, do you
>> remember why you did that? I would't object if this was renamed
>> back to `\arpeggioDown` for consistency...
>
> I would suggest to keep these. These commands are conceptually not
> the same as other Up|Down commands - the \arpeggioArrow* commands
> don't change the position or direction of the grob but rather *add*
> an arrow (pointing up or down). Likewise the \arpeggioNormal command
> does not restore an "automatic" direction, but rather restores a
> normal, un-arrowed arpeggio.
Souds convincing. I'm going to remove the arpeggio commands from this
table; see
https://gitlab.com/lilypond/lilypond/-/merge_requests/2741
Werner