Re: Lilypond Parser Grammar added to manual

[Carl D. Sorensen]

On 4/24/09 11:37 PM, "John Mandereau" <address@hidden> wrote:

> Hi Carl,
> Carl D. Sorensen a écrit :
>> Some time ago I proposed adding a section to the documentation on the
>> lilypond parser grammar.  I didn't know how to follow up on it then, but I
>> still think it's useful, even if it's not perfect.  And I know a lot more
>> now.
>>  
> I think it's useful too.
> 
>> What would need to be done to get
>> 
>> a) lilygrammar.txt in the form that it could be included in the Notation
>> Reference as appendix B.16?
>>  
> It could be just included in a @verbatim block, or formatted as Texinfo
> for more readability.
> 
>> b) The commands to do this automatically added as part of the make process?
>>  
> Add a rule in Documentation/user/GNUmakefile to generate
> $(outdir)/lilygrammar.txt (or .texi), and specify that the Notation
> Reference depends on this file:
> 
> $(outdir)/lilypond.texi: $(outdir)/lilygrammar.txt
> 
> ... or alternatively just wait for me to do it on Sunday night along
> with my other Lily to-do.


Thanks, John, I'll leave it your capable hands.

I've attached a patch that puts the grammar in the Notation Reference as an
appendix, given that lilygrammar.txt is found in Documentation/user.

I've also attached yyout2grammar.py, which needs to be put somewhere in the
build tree (I assume under scripts/auxiliar, but that's out of my domain of
expertise).

I can't commit these changes myself, because they'll break compiling if the
makefile is not updated.  Once you get the makefile fixed, would you please
apply these changes?

Thanks,

Carl

0001-Add-grammar-to-Notation-Reference.patch
Description: 0001-Add-grammar-to-Notation-Reference.patch

yyout2grammar.py
Description: yyout2grammar.py