Re: LilyPond | Various doc issues (!1095)

[Thomas Morley]

Am Mi., 5. Jan. 2022 um 16:45 Uhr schrieb Jean Abou Samra <jean@abou-samra.fr>:
>
>
> > Le 05/01/2022 14:04, Thomas Morley <thomasmorley65@gmail.com> a écrit :
> >
> >
> > Am Mi., 5. Jan. 2022 um 13:28 Uhr schrieb Jean Abou Samra 
> > <jean@abou-samra.fr>:
> > >
> > > [Replying via the mailing list because it's unrelated to Werner's MR]
> > > Le 05/01/2022 12:59, Thomas Morley (@Thomas_Morley)
> > > <gitlab@mg.gitlab.com> a écrit :
> > > [1]Thomas Morley commented on a discussion on
> > > [2]Documentation/en/notation/notation-appendices.itely:
> > > Unrelated to this patch
> > > Though, [3]@jeanas
> > > They do. You might be confused by the change of presentation
> > > Indeed, I was wrong. Alas, in IR the former behaviour added to every
> > > interface:
> > > This grob interface is used in the following graphical object(s):
> > > list-of-grobs
> > > Now
> > > This grob interface is added dynamically to grobs of class
> > > Spanner/Item.
> > > is printed.
> > > I miss this list-of-grobs in the docs now.
> > > Any chance to get this back in the IR for item/spanner-interface or
> > > have this list somewhere in IR linked from thoe interfaces?
> > > That is feasible if we define what it means to be "used": basically
> > > should Footnote be included in this list or not since it will sometimes
> > > have it and sometimes not? Should grobs having the interface
> > > conditionally be in a separate list? The info on _allowable_ classes
> > > (and thus interfaces) is all in define-grobs.scm, it's just a matter of
> > > defining how it should be presented.
> > > Cheers,
> > > Jean
> > > References
> > > 1. https://gitlab.com/Thomas_Morley
> > > 2. 
> > > https://gitlab.com/lilypond/lilypond/-/merge_requests/1095#note_801886836
> > > 3. https://gitlab.com/jeanas
> > IIuc, only 5 grobs may be item _or_ spanner:
> > BalloonText
> > ControlPoint
> > ControlPolygon
> > Footnote
> > Parentheses
> > All others are definitely Items or Spanners.
> >
> > If so, then I'd suggest to have three lists to link to in IR: Items,
> > Spanners, Items-or-Spanners
>
>
> In what section of the IR would be the list of
> items-or-spanners though? Currently they all
> have the sticky-grob-interface, but it's an open
> bet whether they will continue to be characterized
> by an interface in the future because other use
> cases can be found (e.g. perhaps we would want to unify
> PercentRepeat and DoublePercentRepeat?). Maybe rather
> list them in spanner-interface and item-interface?
>

Below sounds nice:

> """
> This interface is used in in the following graphical objects: Foo, Bar, Baz
>
> In addition, this interface is conditionally supported by the following 
> objects: Footnote, BalloonText, etc.
> """

Cheers,
  Harm