From 71134983c25481827e9b031f56820844e6a85234 Mon Sep 17 00:00:00 2001 From: Anatol Belski Date: Sun, 10 Sep 2017 16:45:06 +0000 Subject: [PATCH] Expand on the introduction git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@343046 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/parle/book.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/reference/parle/book.xml b/reference/parle/book.xml index 7cbf1aa473..d53b50b622 100644 --- a/reference/parle/book.xml +++ b/reference/parle/book.xml @@ -8,7 +8,10 @@ &reftitle.intro; - Parle provides lexing and parsing facilities. No Bison, re2c or similar is required. The implementation is based on Ben Hanson's libraries and requires a C++14 capable compiler. + The parle extension provides lexing and parsing facilities. The implementation is based on Ben Hanson's libraries and requires a C++14 capable compiler. Lexers and parsers are generated on the fly and can be used immediately after they've been finalized. Serialization and code generation are not supported by the extension, yet. + + + Lexer analysis is a process of splitting a character sequence into a list of lexemes. The lexeme list can be then used for the syntax analysis against a formal grammar. These operations are also known as lexing and parsing. This documentation doesn't provide any exhaustive information on lexing and parsing, as there are numerous resources on the net touching this topic. The approach of the underlaying libraries used in parle is in most cases compatible to flex and Bison. It is also useful to use Parle\Lexer::dump to inspect the generated state machine, or Parle\Parser::dump to inspect the generated grammar.