> The NR link you gave is very good, especially the last two examples,
> which have the only documentation of inverted and markup as args to
> place-fret.
>
> But those examples are not part of the snippets link [3] that the NR
> describes as "exhaustive". Neither is the use of "white" as an arg
> of place-fret. It only shows white as an override to dot-color,
> where it appears to have an effect more like "inverted" (a circle
> with white fill as opposed to a complete white out).
>
> Trying to find some authoritative definition of place-fret, I first
> tried the index (no hits) then, in case it was a function, I looked in
> the IR function list (no hits).
`place-fret` is part of the `\fret-diagram-verbose` markup; the
documentation you cite is part of the markup's description. Attached
you can see it how it looks like in the PDF version of the NR.
Can you please explain how and why you missed that? While
`place-fret` is just a ('named') list as part of the arguments of that
markup; it is not a function.
> Maybe the snippets examples can be expanded so that they really are
> exhaustive.
I'm not a guitar player; my knowledge of fret diagrams is essentially
zero. If you can cook up examples please help! You can contribute
them easily by adjusting
https://wiki.lilypond.community/wiki/Fret_diagrams_explained_and_developed
The next Wiki import will then update the LilyPond documentation.
> Lilypond's fret diagram code appears to be well-thought-out but still
> with hidden/implicit capabilities. More examples and index entries
> would help show off all that great work.
What index entries (and where) do you want me to add?
Werner