Discuss signature for new function \annotate

[Urs Liska]

Hi,

I want to develop a 'lilypond-doc' package that can be used to
a) document the API of a project or a library and
b) document the musical content of lilypond scores.

You can see an overview of its goals on https://github.com/openlilylib/lilypond-doc/wiki

I urgently need at least the function signature of the core function of b) in order to be able to use it in an existing score, even when I haven't implemented the functionality yet.

As I think this can become a valuable extension and I'd like to see it in LilyPond proper one day I'd like to discuss it on this list before actually starting to work.

On https://github.com/openlilylib/lilypond-doc/wiki/Documenting-musical-content you'll find a quite detailed description what I think the function should look like, attached you'll find an example file showing how I'd use it in a score.

I'm interested in
- general thoughts on the signature design (as I still lack experience with Scheme functions)
- more or different use cases, especially if they'd suggest changes in the signature design

Best
Urs

test-file.ly
Description: Text Data