diff --git a/README.md b/README.md index e6e2e9f..730dd36 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,72 @@ manipulation. Documentation can be found in the [`doc/`][1] directory. -***Note: This project is experimental. There are no known bugs in the parser itself, but the API is -subject to change.*** +***Note: This project is experimental, so the API is subject to change.*** +In a Nutshell +------------- + +Basically, the parser does nothing more than turn some PHP code into an abstract syntax tree. ("nothing +more" is kind of sarcastic here as PHP has a ... uhm, let's just say "not nice" ... grammar, which makes +parsing PHP very hard.) + +For example, if you stick this code in the parser: + +```php +