On 5/18/21, 1:46 PM, "lilypond-user on behalf of Kieren MacMillan"
<lilypond-user-bounces+carl.d.sorensen=gmail....@gnu.org on behalf of
kieren_macmil...@sympatico.ca> wrote:
Hi Ralph,
> I have to admit, after learning from you that the documentation is
accurate, and spending some time examining the various examples in the
documentation, I think I could achieve what I want. It takes some real effort,
and I think it would be difficult for someone who has little experience with
LilyPond. And isn't that the point of the documentation?
Absolutely. My comment was meant as a [gentle] criticism of the
documentation, not of you or other users. Even if it explicitly pointed out
that one needs to *not use* the \repeat volta command, that would be [more]
helpful!
> I think it would be helpful to include an appropriate example in the
manual repeat marks section of the documentation.
Given that the combination of the first three examples at
<https://lilypond.org/doc/v2.21/Documentation/notation/long-repeats#manual-repeat-marks>
is sufficient to solve your example, and the fourth example is almost exactly
what you needed, what would a more appropriate example look like? Would that be
in addition to the existing examples, or as a replacement to one of them?
The sheer size of the Lilypond docs is already pretty overwhelming; just
adding more examples won’t necessarily make it easier for users.
> I guess I'll make a note of the solution!
Some syntactic sugar might be nice… I could imagine a function that took a
list of string+moment pairs and “unfolded” a volta automagically. If my life
ever calms down, maybe I’ll give that a try.
It seems to me that, for right now, Aaron's changeVoltaText function is the
preferred way to do it, as it preserves the \unfoldRepeats behavior (albeit
with warnings).
I'd be in favor of Aaron's snippet being added to the Docs.
Carl
