Integrate the grammar into the reference

[alercah]

The grammar reference at https://doc.rust-lang.org/grammar.html should be integrated into the reference in some fashion, possibly as a separate appendix or possibly just integrated in with individual sections.

[matthewjasper]

see also: #84

[brauliobz]

I've made a script to join all grammar snippets:

https://github.com/brauliobz/rust-reference/blob/grammar_join/join_grammar_snippets.py

The result is something like this:

https://brauliobz.github.io/rust-reference/grammar.html

I was expecting to have the finished grammar before, but I can make a PR if having the incomplete appendix is not a problem.

[willy610]

@brauliobz This is looking good (the .html output) .
Please tell a novis like me where to find the input to your script ..../join_grammer_snippets.py
Something versioned in the compiler source?
I'm totally into producing railroad graphs as an complement to the .html BNF
This is fun!!

[brauliobz]

@willy610 the input is the reference, i.e., all grammar snipets in the .md source files in the src dir. So they're already formatted, which will make things more difficult to you, since you would have to parse the markdown.

The compiler has a grammar, but it isn't optimized for human consumption, since it must adhere to the parser generator mechanics. There's also this one and this one and others I'm unaware of.

[willy610]

Hej Thank you for the generous gudings. Now I will dig into the different sources.

…

On 2018-04-01, at 17:50, Bráulio Bezerra ***@***.***> wrote: @willy610 the input is the reference, i.e., all grammar snipets in the .md source files in the src dir. So they're already formatted, which will make things more difficult to you, since you would have to parse the markdown. The compiler has a grammar, but it isn't optimized for human consumption, since it must adhere to the parser generator mechanics. There's also this one and this one and others I'm unaware of. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.

----------------------------- Willy Svenningsson Johannas Vag 28 S-425 42 Hisings Karra Sweden +46 0768 22 20 26 willy@fager.st