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

[Carl Sorensen <c_sorensen@xxxxxxx>]

On 12/2/09 2:58 PM, "Mats Bengtsson" <mats.bengtsson@xxxxxxxxx> wrote:

> Carl Sorensen wrote:
>> 
>> On 12/2/09 1:40 PM, "Mats Bengtsson" <mats.bengtsson@xxxxxxxxx> 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


---
----
Join the Frogs!