From c78816aa371abf5d3888963ec2eb89c1140b1cce Mon Sep 17 00:00:00 2001 From: Anatol Belski Date: Sun, 10 Sep 2017 17:03:02 +0000 Subject: [PATCH] Add note about trace some description details git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@343048 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/parle/book.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/parle/book.xml b/reference/parle/book.xml index d53b50b622..ca547a855a 100644 --- a/reference/parle/book.xml +++ b/reference/parle/book.xml @@ -8,10 +8,10 @@ &reftitle.intro; - 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. + The parle extension provides lexing and parsing facilities. The implementation is based on Ben Hanson's libraries and requires a C++14 capable compiler. The lexer is based on the regex matching, the parser is LALR(1). 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. + 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, Bison and other similar tools. It is also useful to use Parle\Lexer::dump to inspect the generated state machine, or Parle\Parser::dump to inspect the generated grammar. The method Parle\Parser::trace can be also useful to trace the parsing operation.