Dear Michael,

On Tue, 31 Mar 2026, Michael Scheer wrote:

> a) I have \staffHighlight - where can I look it up? Where do I find
> description of it's properties? methods? like "shorten-pair"? Can I
> maybe have a deeper look into the Scheme foundation of \staffHighlight?
>

I recommend bookmarking Appendix E Index (LilyPond Notation Reference)
<https://lilypond.org/doc/v2.25/Documentation/notation/index-of-commands-and-concepts>
for version 2.25.

When I need to look up a command, the “Index of commands and concepts” is
where I usually start.

(For version 2.24 the equivalent was/is D. LilyPond command index
<https://lilypond.org/doc/v2.24/Documentation/notation/lilypond-command-index>
.)

If you search the index for \staffHighlight you will see two relevant links.

The first link will take you to 7.1 Inside the staff (LilyPond Notation
Reference)
<https://lilypond.org/doc/v2.25/Documentation/notation/inside-the-staff#index-_005cstaffHighlight>
.

If you scroll to the very end of 7.1.6 Staff highlights, you will see
“Internals
Reference: StaffHighlight
<https://lilypond.org/doc/v2.25/Documentation/internals/staffhighlight>,
staff-highlight-interface
<https://lilypond.org/doc/v2.25/Documentation/internals/staff_002dhighlight_002dinterface>,
Staff_highlight_engraver
<https://lilypond.org/doc/v2.25/Documentation/internals/staff_005fhighlight_005fengraver>,
StaffHighlightEvent
<https://lilypond.org/doc/v2.25/Documentation/internals/staffhighlightevent>,
staff-highlight-event
<https://lilypond.org/doc/v2.25/Documentation/internals/staff_002dhighlight_002devent>
.”

The first of those links explains shorten-pair.

b) This is somewhat part of "Horizontal_bracket_engraver" - where will
> I find description, properties/methods doc, its code?
>

I believe that what you need is
https://lilypond.org/doc/v2.25/Documentation/internals/staff_005fhighlight_005fengraver
.

Perhaps someone else can help with your questions about Scheme and source
code.

I hope this is a helpful starting point!

Gabriel

Reply via email to