Status: Accepted
Owner: ----
Labels: Type-Documentation
New issue 3015 by [email protected]: Move Appendix C to the NR,
LilyPond Grammar, to the CG
http://code.google.com/p/lilypond/issues/detail?id=3015
Appendix C to the NR, LilyPond Grammar, is not really useful
to the general user. It should be moved to the CG.
David K said:
"Well, in the last two years, many things have been reimplemented as
music functions, and music functions have become very generic, using
lexical tie-ins here and for other purposes. The number of reserved
words recognized specifically in the grammar has dropped quite a bit.
So a lot of information about LilyPond constructs is no longer in the
grammar, and the grammar contains a lot of "noise" that has no
recognizable relation to the LilyPond language as it is being used.
"This means that the printed grammar has lost much of its utility as a
resource for understanding LilyPond's operation. Instead, its purpose
is mostly figuring out the whereabouts of parser problems. And that is,
indeed, not useful for the average user."
Keith O'H agreed:
"Moving it to Contributors Guide, or removing it entirely, would be
sensible."
