Rename REAMDE to README.md
[nit.git] / src / parser / README.md
index 3595aa7..64ceecf 100644 (file)
@@ -14,6 +14,10 @@ Variable names of the AST usually starts with `n` (for node). This is also histo
 Most files in this directory are generated from a grammar for sablecc3 ( http://www.sablecc.org ).
 In order to generate nit parser, you need the alternate SableCC3 generator ( http://www.mare.ee/indrek/sablecc/ ).
 
+Moreover, the Nit language description file extends the standard SableCC3 syntax and includes parametric productions to factorize the description of the language.
+
+In order to simplify the development of the Nit tools, files produced by the parser generator are committed in the repository; therefore Java and SableCC3 is only required to alter the Nit syntax.
+
 ## Contents
 
 * fact_parser.pl: Script used to factorize parser.nit
@@ -23,7 +27,7 @@ In order to generate nit parser, you need the alternate SableCC3 generator ( htt
 * parser_nodes.nit: token and nodes classes hierarchy used by the parser and the lexer
 * tables.nit, tables_nit.h: Interfaces to access the tables needed by the parser and the lexer
 * xss/*.xss: alternate SableCC3 template files for the Nit language
-
+* org/nitlanguage/gen: A Nit parser in Java, used for tests. use the `make java` rule to build it.
 
 The following are generated but present to avoid the need of sablecc3:
 
@@ -39,4 +43,3 @@ Other temp files produced by the Makefile:
 * .nit.sablecc3: Sablecc3 grammar after processing
 * .nit.sablecc3.dump: Dump of the grammar to improve sablecc3 multiple runs
 * .parser-nofact.nit: The parser generated by SableCC3 before factorization by fact_parser.pl
-