So, there's three "official" grammars for Rust? The one in the documentation, the reference grammar (that serves as documentation and testing) - and the actual grammar, used in the reference implementation? No wonder there are inconsistencies...
Sounds like paring it down to two: a reference/testing grammar that is well documented; perhaps written/maintained with a literate programming tool and the actual implementation is a good idea. Kill off the "only documentation" grammar and/or merge it with the larl-one.
I was also wondering why not autogenerating a "documentation" grammar out of the working code.
Re:Rust Discovery, Or: How I Figure Things Out
by steveklabnik on Tuesday May 12, 2015 @08:43AM
(#9531280)
There were only three temporarily: today, the reference grammar is all gone, subsumed into the documentation/testing grammar.
Note that src/grammar/parser-lalr.y is a reference grammar for testing [1] and the actual implementation is in src/libsyntax, afaik.
[1] - https://github.com/rust-lang/rust/pull/21452