Skip to content

Commit

Permalink
Note ambiguity inherent in using rule identifiers which conflict with…
Browse files Browse the repository at this point in the history
… ranges.

For #8.
  • Loading branch information
gkellogg committed Oct 25, 2020
1 parent 0545329 commit 6f8723c
Showing 1 changed file with 2 additions and 0 deletions.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,8 @@ On a parsing failure, and exception is raised with information that may be usefu
The [EBNF][] variant used here is based on [W3C](https://w3.org/) [EBNF][] (see {file:etc/ebnf.ebnf EBNF grammar}) as defined in the
[XML 1.0 recommendation](https://www.w3.org/TR/REC-xml/), with minor extensions:

Note that the grammar includes an optional `[identifer]` in front of rule names, which can be in conflict with the `RANGE` terminal. It is typically not a problem, but if it comes up, try parsing with the `native` parser, add comments or sequences to disambiguate. EBNF does not have beginning of line checks as all whitespace is treated the same, so the common practice of identifying each rule inherently leads to such ambiguity.

The character set for EBNF is UTF-8.

The general form of a rule is:
Expand Down

0 comments on commit 6f8723c

Please sign in to comment.