On Tue, Dec 10, 2024 at 9:38 PM Werner LEMBERG <w...@gnu.org> wrote: > > >> The policy of LilyPond is to avoid different property names for > >> similar functionality, which often leads to cryptic property > >> descriptions to be as generic as possible. In this particular case > >> an example is given, which is actually a good thing, but it doesn't > >> cover the `centered-spanner-interface` incarnation of this > >> property. > >> > >> Maybe you can suggest a better wording for the description of > >> `spacing-pair`? > >> [...] > > > > On the centered-spanner-interface page, the comment about the > > MultiMeasureRest can just be deleted (as it's already on the > > multi-measure-interface page, as long as the description of > > spacing-pair is correct. > > Exactly this is not possible, because there exists only a single, > global property called `spacing-pair`, which consequently has a > single, global description. > > In other words, the auto-generated documentation sees that an > interface uses `spacing-pair`, and it shows its description. >
Okay, I see now. I guess this makes building the website a lot easier. 8-) Maybe the comment about the MultiMeasureRest should become a Snippet instead. > IIRC, a suggestion in the mentioned thread is to make the property > description displayed for a given grob show which interfaces it is > part of, for example > > ``` > ‘spacing-pair’ (pair) > interface(s): > centered-spanner-interface, multi-measure-interface Yes, but spacing-pair isn't part of the multi-measure-interface. Unless that's something that's being developed. >>> https://lilypond.org/doc/v2.24/Documentation/internals/multi_002dmeasure_002dinterface > default value: > '(break-alignment . break-alignment) > There's a problem there, too, in that the default value depends on the grob. In MeasureSpanner, the default value is (staff-bar . staff-bar) In PercentRepeat, it's (break-alignment . staff-bar) But I guess this is an issue to be mentioned in the other thread. > >> What instrument(s) do you have in mind? It is possible to improve > >> the description while talking about 'left hand' and 'right hand' in > >> the context of fretted instruments, but I don't think it makes > >> sense to change these long-established terms. > > > > The main instrument I'm thinking of is the guitar. > > OK, I see. The probably simplest solution is to explicitly mention > that LilyPond uses the term 'right hand' to actually indicate the > strumming hand. > > > And there's actually precedent, in that left-handed chord diagrams > > (FretBoards) are supported by Lilypond. > > Well, this makes sense, because they are displayed differently. > Also, there's a grob named StrokeFinger. It's not named RightHandFinger. ================================== Christopher Carl Heckman Honors Faculty Teaching Associate Professor 33° 25' 7'' N, 111° 55' 55'' W ECA 212 School of Mathematical & Statistical Sciences Arizona State University (T1N R4E Sect22 NW1/4) Tempe, AZ 85287 - 1804 United States of America North America Planet Earth Solar System Gould Belt Local Bubble Local Fluff Milky Way Galaxy, Orion Arm Local Group Virgo Supercluster Pisces-Cetus Supercluster Complex Universe Multiverse ==================================
