d4cc4d08738faf6df7de5c3a1bfc025f3cc4737e
[nit.git] / src / parser / README
1 This directory contains the nit parser. It is generated from a grammar for sablecc3 ( http://www.sablecc.org ).
2 In order to generate nit parser, you need the alternate SableCC3 generator ( http://www.mare.ee/indrek/sablecc/ ).
3
4 Contents:
5
6         Makefile: Update grammar and generate .nit files
7         nit.sablecc3xx: Extended sablecc3 grammar (see prescc.sh)
8         prescc.sh: Program to transform an extended sablecc3 to a standard one
9         parser_nodes.nit: token and nodes classes hierarchy used by the parser and the lexer
10         test_parser.nit:
11         xss/*.xss: alternate SableCC3 template files for the Nit language
12
13
14 The following are generated but present to avoid the need of sablecc3:
15
16         lexer.nit: generated lexer
17         parser.nit: generated parser
18         parser_prod.nit: All production with generated visit methods
19         parser_tables.nit: Tables needed py the parser
20         parser_abs.nit: Raw generated token and nodes classes used to maintain coherence of parser_nodes.nit
21
22
23 Other temp files produced by the Makefile:
24
25         .nit.sablecc3: Sablecc3 grammar after processing
26         .nit.sablecc3.dump: Dump of the grammar to improve sablecc3 multiple runs
27