New sablecc syntax:
  sablecc [-c cache.file] [-d destination] [-t target|file.xss[,..]] \
      [-p key value] [-o path] filename [filename]...

This file describes the alternative generation system usage.
Currently available language targets and parameters:

Java
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  java
  java-build
    - package = <default from grammar file>
    - src = '.'

C++
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  cxx
  cxx-build
    - package = <default from grammar file> - namespace in C++

C#
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  csharp
  csharp-build
    - package = <default from grammar file>

XML
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  xml

Graphviz's DOT graph visualization
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  dotgraph-simple
      Will generate a simple non-repeated DAG

  dotgraph-tree
      Will generate a DAG but repeat productions unless they are
      already specified up the tree (no recursion, DAG)

  dotgraph-graph
      Will generate a true graph.

For example to generate java parser with source files under src/
directory and also generate the build.xml and README.parser files
run following:

  % sablecc -t java,java-build -p src src grammar-file.sablecc3

In practical development process one might choose to generate
the build systems only once and later modify those by hand.
See individual README.parser files for more information in the
generated parser source tree.

Caching (-c)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The new sablecc's -c option is currenly mostly useful for xss
writers/developers as grammar analysis is skipped.