android13/external/antlr/runtime/Perl5
liiir1985 7f62dcda9f initial 2024-06-22 20:45:49 +08:00
..
docs initial 2024-06-22 20:45:49 +08:00
examples initial 2024-06-22 20:45:49 +08:00
lib/ANTLR initial 2024-06-22 20:45:49 +08:00
t initial 2024-06-22 20:45:49 +08:00
tools initial 2024-06-22 20:45:49 +08:00
.p4ignore initial 2024-06-22 20:45:49 +08:00
Build.PL initial 2024-06-22 20:45:49 +08:00
Changes initial 2024-06-22 20:45:49 +08:00
INSTALL initial 2024-06-22 20:45:49 +08:00
MANIFEST initial 2024-06-22 20:45:49 +08:00
MANIFEST.SKIP initial 2024-06-22 20:45:49 +08:00
Makefile.PL initial 2024-06-22 20:45:49 +08:00
README initial 2024-06-22 20:45:49 +08:00
port.yml initial 2024-06-22 20:45:49 +08:00

README

ANTLR::Runtime

This is the Perl 5 runtime for ANTLR.  It is currently under early
development.  Most parts are not working yet, and some of those that are need
to catch up with the current development version.  The good news is that some
parts are working, as illustrated by the examples.  You'd probably want to
take a look at examples/expr/.


KNOWN ISSUES
============

* Perl's syntax clashes with ANTLR's StringTemplate ('%') and variable ('$')
syntax.  Expect error messages like the following.

error(146): Expr.g:10:10: invalid StringTemplate % shorthand syntax: '%memory'
error(114): Expr.g:18:9: attribute is not a token, parameter, or return value: memory
error(114): Expr.g:36:9: attribute is not a token, parameter, or return value: v

Currently, it's best to check the syntax of the generated code, like so:

$ perl -c ExprLexer.pm
ExprLexer.pm syntax OK

$ perl -c ExprParser.pm
ExprParser.pm syntax OK

Or use the lexer/parser in an example.