How to run SableCC

• SableCC version 2.18.2, is very stable, but does not include the automatic CST-to-AST transformations that SABLECC 3 supports.
• SableCC version 3-beta.3, should also be quite stable, and it does offer the very nice features of providing a nice way of producing an AST. There is limited documentation on this version, but it is not hard to use, and several examples are provided below.
• Both versions are installed on the SOCS teaching network. Note that tar.gz files are also provided for both versions if you wish to install them on your own machines. Note that to do a full install you will need to use ant . If you just want to run SableCC then you really only need the sablecc.jar file which can be found in the lib/ subdirectory for each version.

  On a teaching network machine you can examine the directory ~hendren/SableCC/ , from the web you can visit it via this symbolic link. .

• setting the SABLECCDIR
  setenv SABLECCDIR ~hendren/SableCC/sablecc-2.18.2
  or setenv SABLECCDIR ~hendren/SableCC/sablecc-3-beta.3
  depending on which version of SableCC you would like to use.
• and then compile a sablecc specification file, foo.sablecc , as follows:
  java -jar $SABLECCDIR/lib/sablecc.jar foo.sablecc Of course, you may define your own alias or script to make this command more convenient. A sample makefile is also available in the first example below.

Examples of using SableCC version 2 are found in:

• Small Expression Language used in 308-520 lectures: ~hendren/SableCC/EXP/SableCC2/
• Java version of the JOOS compiler: ~hendren/SableCC/JJOOS/ The complete compiler and report are available in a gzipped tar package at ~hendren/SableCC/JJOOS.tar.gz.
• SourceForge (src tree) or SourceForge (goto download link for SableCC Grammars)

Examples of using SableCC version 3 are found in:

• Small Expression Language used in 308-520 lectures: ~hendren/SableCC/EXP/SableCC3/ . It is instructive to compare the two versions of this small example, to see the difference between SableCC2 and SableCC3.
• An excellent illustrative example, which shows all the main features of SableCC version 3, is provided at http://www.mare.ee/indrek/sablecc/#example . A local copy of this code is found at http://www.cs.mcgill.ca/~hendren/SableCC/IndrekExample/.
• Java version of the JOOS compiler, rewritten to use SableCC3: ~hendren/SableCC/JJOOS3/ The complete compiler and report are available in a gzipped tar package at ~hendren/SableCC/JJOOS3.tar.gz.