On 29-Apr-05, at 12:44 AM, Han-Wen Nienhuys wrote:
Op do, 28-04-2005 te 17:38 -0700, schreef Graham Percival:I'm proposing that we add a chapter (to become the new chapter 4) which
demonstrates practical examples of lilypond. For example,
We went away from commented wordy examples in the tutorial (a long time ago, I believe for 1.4 or 1.6), because we felt they weren't clear enough. Perhaps, in this case, the actual documentation of titling, markup and header should first be revised so it shows more examples and is clearer?
The response I've gotten (both public and private) is that text markup definitely needs better docs. I'll work on that now. People don't seem to realize that you can do anything with titles that you can do with text markup; I'll also make this more obvious.
I'll try to figure out how lyrics work, too, but the archives are down right
now.
The basic problem with complex examples, is that they're difficult to read if you don't already know what they say.
I confess that I haven't completely thought out what to do with this new possible chapter. I'm pretty sure that we could use another wordy chapter that explains some of the more complicated lilypond stuff; I'm not certain whether that should take the form of annotated short examples, annotated complicated contrived examples, or just an extension of the existing tutorial (but in a separate chapter for ease of reading).
If we're going to have a new chapter, IMO it should be included before 2.6.0. We've rearranged the manual between 2.4 and 2.6, so users will have to get used to a new chapter numbering scheme; it would be a pity if 2.6.5 (or whatever) introduced a new chapter which changed the chapter numbering scheme again.
I'll fix the current text markup stuff and make a more concrete proposal in a few days.
Cheers, - Graham
_______________________________________________ lilypond-devel mailing list [email protected] http://lists.gnu.org/mailman/listinfo/lilypond-devel
