Graham - AllAbout examples usually will be much larger than the LSR entries and too big for the manual. Think about an AllAbout that displays all font sets, one to demonstrate vertical layout options for a multipage score, one showing lots of ways to use \markup, or the many ways to enter and display rests. The concept is to build near exhaustive examples of very narrow topics.
The LSR entries seem to be short things that haven't made the cut for Tips
and Tricks or Regression Tests. Further, I find the LSR out of the
mainstream (not linked from the LilyPond documentation page) and awkward to
use (don't find a way to download as a one-big-page searchable html or pdf).
If "Examples" has another use, consider adding a parallel for the AllAbouts.
AllAboutAlternateScaling.ly is attached, a work in progress but maybe useful
enough to post as is. I'll try uploading to LSR.
- Bruce
-----Original Message-----
From: Graham Percival [mailto:[EMAIL PROTECTED]
Sent: Saturday, June 24, 2006 12:48 AM
To: Fairchild
Cc: 'Kieren MacMillan'; 'lilypond-user Mailinglist'
Subject: Re: AllAbout Examples
On Thu, 22 Jun 2006 13:34:43 -0500
"Fairchild" <[EMAIL PROTECTED]> wrote:
> However, based in my own experience and many postings on
> lilypond-user@gnu.org, I perceive a need for information that falls
> between content of tutorial and reference documentation -- more
> detailed than the tutorial material and less cryptic than the
> internals reference.
Chapter 3 or 5?
> I propose using the rendered "Examples" section of the documentation
> (now empty) to post a series of AllAbouts, prepared by users, each
> being an in-depth example of a narrow set of features: fonts, layout,
> header, embedded PostScript, rests, lyrics, tuplets, markup, etc. (The
> user perspective is valuable to identify information found difficult
> to extract from existing documentation.)
This could be interesting, but it would have to tie in with other work on
rearranging the examples. I suppose I could work on this next...
I'll look into this and start discussing things on -devel. Hopefully I'll
have something to report in a week.
In the mean time, could you post some examples of this to LSR? It would be
helpful to see exactly what you're proposing... and my proposal involves
LSR, so if it works out you'll be uploading it to LSR anyway. :)
- Graham
AAAlternateScaling.ly
Description: Binary data
_______________________________________________ lilypond-user mailing list lilypond-user@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-user
