danog/PHP-Parser
1
0
Fork 0
mirror of https://github.com/danog/PHP-Parser.git synced 2024-11-26 20:04:48 +01:00
Code Issues Projects Releases Wiki Activity

Add README for grammar folder

Browse Source
This commit is contained in:
nikic 2011-06-26 20:56:35 +02:00
parent d94cd1998b
commit dd13cd4fe9
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
grammar/README.md Normal file
View File

@ -0,0 +1,25 @@
What do all those files mean?
=============================
* `zend_language_parser.y`: Original PHP grammer this parser is based on
* `zend_language_parser.pre.phpy`: PHP grammer written in a pseudo language, which is transformed
into a proper `kmyacc` grammer using `preprocessor.php`
* `zend_language_parser.phpy`: PHP grammer ready for `kmyacc`
* `analyzer.php`: Analyzes the `.pre.phpy`-grammer and outputs some info about it
* `preprocessor.php`: Transforms a `.pre.phpy` grammar into a `.phpy` grammar
* `rebuildParser.php`: Builds the actual parser by calling `kmyacc`
* `php.kmyacc`: A `kmyacc` parser prototype file for PHP
* `y.output`: `kmyacc`s debug output
.pre.phpy pseudo language
=========================
The `.pre.phpy` file is a normal grammer in `kmyacc` (`yacc`) style, with some transformations
applied to it:
* Nodes are created using the syntax `Name[subNode1: ..., subNode2: ...]`. This is transformed into
`new PHPParser_Node_Name(array('subNode1' => ..., 'subNode2' => ...), #this->line)` (`#` is used
instead of `$` because `$` is a reservered character in `kmyacc` grammars. It is later transformed
back to `$`)
* `Name::abc` is transformed to `PHPParser_Node_Name::abc`
* Some function-like constructs are resolved (see `preprocessor.php` for a list)