README

@Name@ (@name@ version @version@)
@copyright@
All rights reserved.




     NZDIS FIPA SL parsing tools  version 1.2
     ----------------------------------------




  Building from sources
  =====================

  Required components:
  * SableCC 2.17.2 or newer (http://sourceforge.net/projects/sablecc)
  * ANT 1.3 or compatibile  (http://jakarta.apache.org/ant)

  You need to have sablecc.jar in your CLASSPATH and ANT
  installed. To build executable jar just type:

    ant

  in the top level directory.



  Using the package
  =================
  
  Place the nzdis-fipasl.jar in your classpath, read the generated
  Javadocs for the Abstract Syntax Tree details, write your custom
  AST tree walker using the visitor pattern 
  (see analysis/DepthFirstAdapter.java)




  Printing the AST tree
  =====================

  The generated binary jar is in fact an executable jar, which allows
  the user to validate a FIPA-SL input, and display the Abstract Syntax
  tree as a text on a console or as a GUI tree. Type for example:

     java -jar nzdis-fipasl.jar [--gui] examples/arithmetics.sl




  Contact and Feedback
  ====================

  If you have any question, send an electronic message to
  Mariusz Nowostawski <mariusz@rakiura.org>, or write to:

  Mariusz Nowostawski
  Information Science Department
  University of Otago
  PO BOX 56
  Dunedin, New Zealand


  To subscribe to the NZDIS FIPA SL mailing list visit:
  http://lists.sourceforge.net/lists/listinfo/sablecc-nzdis 
    

  If you you want to submit a bug report, or a patch, please visit the
  SableCC Grammars web site:
  http://sablecc.sourceforge.net/