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

[Graham Percival]

On Wed, Dec 02, 2009 at 03:41:06PM -0700, Carl Sorensen wrote:
> 
> On 12/2/09 2:58 PM, "Mats Bengtsson" <address@hidden> wrote:
> 
> >> 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.

That's not _entirely_ true; there's the maoing
Documentation/included/.  I'd like to get rid of it, but that
would be a 1- or 5-hour (me vs newbie) task that has relatively
little payoff.

> 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.

After counting the items in the original email, it's literally 12
of one, and a dozen of the other.

Appendices are generally for large lists; as far as I see, all the
appendices have at least 100 items in them.  I don't know quite
where the ideal cutoff would come, but my initial feeling is that
it'd be somewhere around 30.

So I think in this case, a snippet is appropriate.

Cheers,
- Graham