[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] Docs: IR: Move 'details to user grob property list
From: |
Carl D. Sorensen |
Subject: |
Re: [PATCH] Docs: IR: Move 'details to user grob property list |
Date: |
Mon, 6 Apr 2009 06:47:53 -0600 |
On 4/6/09 3:48 AM, "Patrick McCarty" <address@hidden> wrote:
> On Mon, Apr 06, 2009 at 09:37:09AM +0200, Mats Bengtsson wrote:
>>
>>
>> Patrick McCarty wrote:
>>>
>>> So, is the patch okay as it is?
>>>
>> Don't refer to *.cc files for more information on the subproperties in
>> details. These are (or at least should be) described in the
>> corresponding *-interface documentation. See for example
>> http://lilypond.org/doc/v2.12/Documentation/user/lilypond-internals/stem_002d
>> interface#stem_002dinterface
>> for documentation of the stem related subproperties.
>
> Thanks Mats, I did not think of doing that.
>
> This will be a task in itself. For example, Tie has 26 different
> subproperties of 'details to document!
>
This documentation *has* to be automatically generated. But I don't know
the architecture for allowing this.
I think that we should go ahead with this patch, and leave the *.cc
reference in, until we can figure out a way to automatically document the
details property properly for each separate grob.
That's why we created a *separate* fret-diagram-details property. It was
easily documented as a separaate property, with each of the details included
in the description.
Anybody up for developing a self-documenting architecture for details?
Thanks,
Carl
- [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/02
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Francisco Vila, 2009/04/03
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Carl D. Sorensen, 2009/04/03
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/03
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Mats Bengtsson, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list,
Carl D. Sorensen <=
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Mats Bengtsson, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Carl D. Sorensen, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Mats Bengtsson, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Carl D. Sorensen, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Carl D. Sorensen, 2009/04/06
- Re: [PATCH] Docs: IR: Move 'details to user grob property list, Patrick McCarty, 2009/04/06
Re: [PATCH] Docs: IR: Move 'details to user grob property list, Han-Wen Nienhuys, 2009/04/03