[antlr-interest] [v3] Lack of documentation

[Eric Bruno]

I have to disagree about the negative comments regarding the Antlr book. 
I found it very readable and well written for people new to Antlr.
My expectation of the book was for it to tell me what Antlr was, why I 
cared and to cover basic use of
the tool.  For me it meet those goals. 
It is book I feel I can give to people who have never used Antlr or lex 
and Yacc
and have a expectation they can start using the tool in a couple of days.

So for what's worth I think Ter did very good job with the book, from a 
readability point of view
I would put in the same class as Richard Steven's Unix book's which from 
me is high praise.
Eric Bruno

Harald Wellmann wrote:
> Getting started with ANTLR v3 is a frustrating experience for its lack of
> coherent documentation and non-trivial example code.
>
> I've been using ANTLR since the good old times when it used to be called
> PCCTS, and I always used to be fond of it, but I am disappointed with v3.
>
> Marketing-style hype about the latest cool features does not really help
> when you get no little or no information on how to use them.
>
> Even v2 documentatation was a bit scarce, it always cost you some trial and
> error to get things right, but this was bliss compared to the scattered and
> incomplete bits of documentation you get for v3.
>
> Yes, I know there's a book now. And no, I don't think it's in the spirit of
>  a successful open source project to hide all relevant information in a
> book that is only available commercially.
>
> There's nothing wrong about books, but you can publish a book and still
> make the information publicly available, see e.g. the Subversion Book.
>
> By the way, even this mailing list is inaccessible to most people in a
> corporate IT environment, as the Mailman Frontend is running on a
> non-standard port 8080 which tends to get blocked by firewalls.
>
> Regards,
>
> Harald
>