[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: collision beam with staff-crossing beam
From: |
address@hidden |
Subject: |
Re: collision beam with staff-crossing beam |
Date: |
Wed, 13 Feb 2013 11:49:07 +0100 |
On 13 févr. 2013, at 11:34, David Kastrup <address@hidden> wrote:
> "address@hidden" <address@hidden> writes:
>
>> On 13 févr. 2013, at 11:06, Werner LEMBERG <address@hidden> 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
- collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/12
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/12
- Re: collision beam with staff-crossing beam, Janek Warchoł, 2013/02/12
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, address@hidden, 2013/02/13
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, address@hidden, 2013/02/13
- Re: collision beam with staff-crossing beam, David Kastrup, 2013/02/13
- Re: collision beam with staff-crossing beam,
address@hidden <=
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, address@hidden, 2013/02/13
- Re: collision beam with staff-crossing beam, David Kastrup, 2013/02/13
- Re: collision beam with staff-crossing beam, address@hidden, 2013/02/13
- Re: collision beam with staff-crossing beam, David Kastrup, 2013/02/13
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, David Kastrup, 2013/02/13
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, Werner LEMBERG, 2013/02/13
- Re: collision beam with staff-crossing beam, David Kastrup, 2013/02/13