On 13 févr. 2013, at 11:34, David Kastrup <d...@gnu.org> wrote:

> "m...@mikesolomon.org" <m...@mikesolomon.org> writes:
> 
>> On 13 févr. 2013, at 11:06, Werner LEMBERG <w...@gnu.org> wrote:
>> 
>>> 
>>>> \override Beam.Y-extent = #'(0 . 10)
>>>> \override Beam.vertical-skylines =
>>>>            #ly:grob::simple-vertical-skylines-from-extents
>>> 
>>> Nice!  And completely undocumented, of course...
>> 
>> There are currently around 100 callbacks in LilyPond for various
>> properties (check out anything in define-grobs.scm starting with ly:).
>> For most of them, there is no way to know how they work unless one
>> reads code.  In the documentation build, there is no mechanism to
>> document what these callbacks do.
> 
> Every callback can have a documentation string, and quite a few do.
> They are not included in the printed documentation yet, but at least
> they are in the source at an obvious place.
> 

git grep MAKE_DOCUMENTED_SCHEME_CALLBACK
git grep MAKE_SCHEME_CALLBACK

>> It would be fantastic to have the systematic documentation of all of
>> these callbacks in some form of API.  Would you be interested in
>> organizing this?  I would be happy to help.
> 
> It is just a matter of writing documentation strings as you invent new
> callbacks.  Pretty much a no-brainer not needing any organization.
> 

It is definitely a brainer, as it would require retroactively documenting 276 
MAKE_SCHEME_CALLBACKs.  It would take coordinated effort to get all of this 
stuff documented.

Cheers,
MS


_______________________________________________
lilypond-user mailing list
lilypond-user@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-user

Reply via email to