Hello Michal,
On Sun, 13 Jun 2010 20:15:46 +0000, BCS wrote:
The first thing to do is put all of the description of the grammar in
the docs into one place.
If we are at it, it would be good to enhance visual representation of
docs by generate syntax diagram, similarly as on http://www.json.org/
it not only helps to learn and understand grammar, but also lowers the
barrier to just looking at it. When I first saw this kind of diagrams
on JSON site, it made good impression on me.
[...]
Nice idea. (But I'd put them in a different set of cross linked pages.)
If there is interest in such diagrams, and there is one file syntax
file, I would be willing to make changes to this tool (C#) to be able
to batch- generate these images. (It would be also a good idea to look
at first if BNF diagrams look good, and if EBNF isn't necessary.)
You might not need to change the tool. If the grammar macros are done with
some thought, you might be able to make them render it to whatever that tool
already take as input.
--
... <IXOYE><
