[antlr-interest] ANTLR Documentation
Krupa Benhur
krupa_gadde at yahoo.com
Mon Oct 21 22:06:31 PDT 2002
Hi Terence,
Adding to want David said, it would be nice if you can include some more examples in the documentation. Looking forward for the book from you.
Thanks
Benhur
David Wigg <wiggjd at sbu.ac.uk> wrote:With reference to restructuring of documentation it would be
nice to have a really good book but in two/three years time?
In the meantime we have some good documentation which is usually
a great help. What would be really nice now is to have the
existing documentation updated as corrections and clarifications
are brought to light and then we wouldn't have to waste time
with FAQs.
For instance last week I drew attention to the fact that under
the heading of "Lexer Analysis with ANTLR" there is a paragraph
on "Keywords and Literals" under "Lexical Rules" in which there
is a sentence "Second, literals may be specified in the lexer
grammar by means of the literal option." I cannot find a
"Literal" option. There is a "testLiterals" option but this is
different and not what I was looking for.
I think I found what I was looking for under "Tokens Section" in
"ANTLR Meta-Language" where it explains how a literal can
be allocated to a token.
I don't know yet whether the parse will actually work correctly
but using a tokens section I was able to get rid of a lexical
nondeterminism between OPERATOR ("operator") and ID (in C++).
If I am correct please could the documentation be updated
without the need for a FAQ?
What I would like to say is that more often than not wouldn't
updating the documentation be better that loading another FAQ?
And I think correct, clear and understandable up to date
documentation would help writing the book, wouldn't it?.
David.
Your use of Yahoo! Groups is subject to http://docs.yahoo.com/info/terms/
---------------------------------
Get a bigger mailbox -- choose a size that fits your needs.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.antlr.org/pipermail/antlr-interest/attachments/20021022/d281bb16/attachment.html
More information about the antlr-interest
mailing list