[Lilypond-auto] Issue 3015 in lilypond: Move Appendix C to the NR, LilyPond Grammar, to the CG

[lilypond]

Status: Accepted
Owner: ----
Labels: Type-Documentation

New issue 3015 by address@hidden: 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."