2011-06-26 20:56:35 +02:00
|
|
|
What do all those files mean?
|
|
|
|
|
=============================
|
|
|
|
|
|
2016-08-11 16:17:08 +02:00
|
|
|
* `php5.y`: PHP 5 grammar written in a pseudo language
|
|
|
|
|
* `php7.y`: PHP 7 grammar written in a pseudo language
|
|
|
|
|
* `tokens.y`: Tokens definition shared between PHP 5 and PHP 7 grammars
|
|
|
|
|
* `parser.template`: A `kmyacc` parser prototype file for PHP
|
|
|
|
|
* `tokens.template`: A `kmyacc` prototype file for the `Tokens` class
|
|
|
|
|
* `rebuildParsers.php`: Preprocesses the grammar and builds the parser using `kmyacc`
|
2011-06-26 20:56:35 +02:00
|
|
|
|
2011-08-04 12:46:48 +02:00
|
|
|
.phpy pseudo language
|
2011-08-14 14:52:24 +02:00
|
|
|
=====================
|
2011-06-26 20:56:35 +02:00
|
|
|
|
2017-10-31 22:47:42 +01:00
|
|
|
The `.y` file is a normal grammar in `kmyacc` (`yacc`) style, with some transformations
|
2011-06-26 20:56:35 +02:00
|
|
|
applied to it:
|
|
|
|
|
|
2011-10-28 19:06:24 +02:00
|
|
|
* Nodes are created using the syntax `Name[..., ...]`. This is transformed into
|
2015-04-30 21:58:45 +02:00
|
|
|
`new Name(..., ..., attributes())`
|
2016-08-11 16:17:08 +02:00
|
|
|
* Some function-like constructs are resolved (see `rebuildParsers.php` for a list)
|
2011-08-14 14:52:24 +02:00
|
|
|
|
|
|
|
|
Building the parser
|
|
|
|
|
===================
|
|
|
|
|
|
2019-10-19 15:24:38 +02:00
|
|
|
Run `php grammar/rebuildParsers.php` to rebuild the parsers. Additional options:
|
2011-11-27 13:22:29 +01:00
|
|
|
|
2019-10-19 15:24:38 +02:00
|
|
|
* The `KMYACC` environment variable can be used to specify an alternative `kmyacc` binary.
|
|
|
|
|
By default the `phpyacc` dev dependency will be used. To use the original `kmyacc`, you
|
|
|
|
|
need to compile [moriyoshi's fork](https://github.com/moriyoshi/kmyacc-forked).
|
|
|
|
|
* The `--debug` option enables emission of debug symbols and creates the `y.output` file.
|
|
|
|
|
* The `--keep-tmp-grammar` option preserves the preprocessed grammar file.
|
