I think it would be nice to have the option to dump a raw graphviz DOT file instead of the sppf.png for a few reasons:

• the file size is a lot smaller
• it's nice to be able to "do things" with the resulting tree in its structured form, rather than navigate the rendered bitmap
• it's only one extra (or no extra) line and could be optional, e.g. if you've turned on "debug" mode.

Any though

From @tamaranga on February 1, 2014 9:39

It's impossible to create class:

class HTML {
}

and method:

class Test {
      public function HTML() {}
}

Maybe it is not so difficult to allow such capitalized names or describe this limitation in docs. Currently it's just "ParseException: Syntax error", that is not very obvious.

in docs/actions/#built-in-actions you write:

collect_optional - Can be used for rules of the form
Elements: Elements Element | Element | EMPTY;
Returns list;

Shouldn't that be Elements: Elements Element | EMPTY;?
This pattern is also in docs/grammar_language#zero-or-more

collect_sep_optional - Can be used for rules of the form
`Elements: Elements separator Ele

Similar to GOLD Parser's website generator, farkle describe will generate a documentation file for a grammar.

Features

• It must support Markdown (it's the lingua franca of documentation) and very readable by humans.
  • The most architecturally beautiful way to implement it is using Scriban. Of course we would allow the u

Ideia do @pyperanger. Os comentários não serão mais ignorados, e serão utilizados para gerar a documentação em markdown.