lilypond-user
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [frogs] Re: format-mark-* Was: \set vs \override


From: Carl Sorensen
Subject: Re: [frogs] Re: format-mark-* Was: \set vs \override
Date: Wed, 2 Dec 2009 15:41:06 -0700



On 12/2/09 2:58 PM, "Mats Bengtsson" <address@hidden> wrote:

> Carl Sorensen wrote:
>> 
>> On 12/2/09 1:40 PM, "Mats Bengtsson" <address@hidden> wrote:
>> 
>>  
>>> Why not simply extend the current example so that it shows all the
>>> possibilities? No need to explain in words, especially since the names
>>> are more or less self-explanatory.
>>>    
>> 
>> Because it's too many things to list in the body of the NR.  We try to keep
>> the body of the NR as short as feasible, and put exhaustive lists in the
>> appendices.
>>  
> Really? We already include many LSR snippets that are fairly large. Why
> not do it that way?

We don't include any LSR snippets in the main body of the manual.

Snippets in the main body of the manual are inlined in the manual.

LSR snippets appear in the "Selected Snippets" section (following the main
explanation).

Exhaustive lists are in the appendices.

We could certainly create an LSR snippet that listed all the possibilities,
and have that show up in the Selected Snippets section instead of in the
appendix.

But I think it's more consistent with the GDP manual ordering to do it with
an Appendix.


Graham, what do you think?  You're the last word on documentation standards.

Thanks,

Carl





reply via email to

[Prev in Thread] Current Thread [Next in Thread]