On Wed, Dec 02, 2009 at 03:41:06PM -0700, Carl Sorensen wrote: > > On 12/2/09 2:58 PM, "Mats Bengtsson" <mats.bengts...@ee.kth.se> 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 _______________________________________________ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user