On 9/27/09 11:55 AM, "John Mandereau" <john.mander...@gmail.com> wrote:
> Le dimanche 27 septembre 2009 à 17:37 +0100, Graham Percival a écrit :
>> How much of scheme do we get into, though? I mean, what about
>> moving it back into Notation?
>
> This would be wrong: even if we expanded it up to make a big chapter, it
> would not become reference documentation (we alreadhy have Notation Ref.
> 6 "Interfaces for programmers" and the Internals Reference for this), it
> would remain learning material.
>
>
>> As far as I'm concerned, as long as newbies know that it's
>> *possible* to do all sorts of funky stuff with this magical scheme
>> stuff, that's all they need to know. I mean, nobody can seriously
>> complain that we're newbie-unfriendly by not explaining how to
>> make noteheads automatically change size based on their staff
>> position!
>
> Certainly. However, when we decide time has come to significantly
> expand this appendix and it gets too big to remain an appendix, we'll
> have to reword the reading guidelines so the reader doesn't feel he
> should even read this chapter, e.g. by recommending that "all this
> manual should be read from cover to cover, except the last chapter
> "Scheme tutorial", that can be read later to make better use of Chapters
> 5 and 6 of the Notation Reference, for example."
I think that my preference would actually to create a LilyPond Programming
manual, with the Scheme Tutorial and a rewritten NR6. I don't think that
NR6 is actually Notation Reference. That particular chapter has seemed to
me to be out of place anyway.
Thanks,
Carl
_______________________________________________
lilypond-devel mailing list
lilypond-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-devel
