> It's a little strange that [`ignore-ambitus`] is documented under
> AmbitusNoteHead when it really doesn't have anything to do with the
> note heads of the ambitus itself.
You are mistaken. Looking up properties for a grob in the Internals
Reference is the wrong way; this only shows default values for
properties but not the available properties. Instead, you should
always check which *interface* a property belongs to – the
`ignore-ambitus` property is part of the `note-head-interface`. As
you might have guessed, `NoteHead` uses the `note-head-interface`
also, and the `Ambitus_engraver` walks over such grobs to collect (or
exclude) notes for the ambitus range.
Note also that there is no guarantee in general that properties
provided by an interface are actually used by a grob. As you
correctly observe, `AmbitusNoteHead` does nothing with
`ignore-ambitus`.
> It should be explained on the main Ambitus documentation page.
No, it should not. If we documented all and every property in the
Notation Reference, it would be three times as long as it is already.
Please add a snippet to the Wiki, which can then be eventually added
to the 'Snippets' manual.
Werner
