<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Terence Parr wrote:
<blockquote cite="mid:B9012A3A-223A-4E78-99BB-9BC5C07695E5@cs.usfca.edu"
 type="cite">
  <pre wrap="">Hi. Isn't it annoying though to get a description of something (say in  
a printed book) and then have to go to the machine to read along in  
the code?
  </pre>
</blockquote>
Personally, given the subject matter, I would think that most people
would actually prefer code snippets with lots of explanations and be
referred to a download of all the source code. Generally I think people
will want to 'steal' the code and adapt it to their own tasks and if
you really want to read the code on the plane or something, then you
can always transfer it to a suitable medium, including printing it out.
<br>
<br>
This also minimizes how much of it will go out of date and need changes
as we change ANTLR. This is because it is unlikely that the techniques
will change, but some things about ANTLR syntax definitely will; if the
book has the code for a symbol table lookup and scope, then it will be
very relevant, but the expression parser might be totally different in
a years time when you stop working for a living and start coding all
that new stuff. I am thinking explicitly of the proposed expression
changes, error catching syntax we discussed, keyword as variable
handling and so on.<br>
<br>
That's my personal opinion of course, but that's why you are discussing
it here :-)<br>
<br>
Jim<br>
<br>
<blockquote cite="mid:B9012A3A-223A-4E78-99BB-9BC5C07695E5@cs.usfca.edu"
 type="cite">
  <pre wrap="">
Ter
On Jun 5, 2009, at 12:29 PM, Edwards, Waverly wrote:

  </pre>
  <blockquote type="cite">
    <pre wrap="">I am getting quite a bit out of the descriptions of the patterns.
I think that by giving the descriptions you provide the framework so  
if
someone were to look at code, it will make sense.  If I had code but
less description of the pattern then the moment of discovery may not
occur.  I am really liking the descriptions and the inline reference
to other pages or chapters.  I see how they are related and the mental
connections are being made.  I think if you read the book and look at
the related source code outside of the book, it will make sense but
the reverse would not be true.

Also putting the full source puts pressure to leave something else  
out.

I favor a robust pattern description.


W.

-----Original Message-----
From: Terence Parr [<a class="moz-txt-link-freetext" href="mailto:parrt@cs.usfca.edu">mailto:parrt@cs.usfca.edu</a>]
Sent: Friday, June 05, 2009 1:40 PM
To: Edwards, Waverly
Cc: antlr ANTLR
Subject: Re: [antlr-interest] "Language design patterns" book  
available in beta

Glad to hear the book is meeting your expectations. I only have about
80 pages left and I just consumed 26 of those four the first of the
interpreter chapters. doh!

If I have to skimp to make it into only 350 pages, where should I be
terse? should I skip patterns or should I include the full source code
for the pattern and a less verbose description?

Ter

On Jun 5, 2009, at 7:00 AM, Edwards, Waverly wrote:

    </pre>
    <blockquote type="cite">
      <pre wrap="">I'll pay extra for the extra material.
      </pre>
      <blockquote type="cite">
        <pre wrap="">From what I've seen so far, it will be well worth it.
        </pre>
      </blockquote>
      <pre wrap="">
W.

-----Original Message-----
From: <a class="moz-txt-link-abbreviated" href="mailto:antlr-interest-bounces@antlr.org">antlr-interest-bounces@antlr.org</a> [<a class="moz-txt-link-freetext" href="mailto:antlr-interest-bounces@antlr.org">mailto:antlr-interest-bounces@antlr.org</a>
] On Behalf Of ugol
Sent: Thursday, June 04, 2009 6:28 PM
To: Terence Parr
Cc: String Template Mailing LIst; antlr ANTLR
Subject: Re: [antlr-interest] "Language design patterns" book
available in beta

      </pre>
      <blockquote type="cite">
        <pre wrap="">ha! Yeah, we don't want to create a very intimidating huge book
though.

I know what you mean. as I started this interpreter chapter, I felt
like I  could finally start the book! I had gone through all of the
preliminary material.  Readers could parse, build an intermediate
representation, walk trees, track and resolve symbols, and do
semantic
analysis such as static type checking.

        </pre>
      </blockquote>
      <pre wrap="">If you really run out of pages, just publish additional material on
the site... but limitating the most interesting part of the book is
crazy!!!!!

-- 
uL

Pragmatist
<a class="moz-txt-link-freetext" href="http://blog.ugolandini.com">http://blog.ugolandini.com</a>
<a class="moz-txt-link-freetext" href="http://www.flickr.com/photos/ugol/">http://www.flickr.com/photos/ugol/</a>

List: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/listinfo/antlr-interest">http://www.antlr.org/mailman/listinfo/antlr-interest</a>
Unsubscribe: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/options/antlr-interest/your-email-address">http://www.antlr.org/mailman/options/antlr-interest/your-email-address</a>

List: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/listinfo/antlr-interest">http://www.antlr.org/mailman/listinfo/antlr-interest</a>
Unsubscribe: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/options/antlr-interest/your-email-address">http://www.antlr.org/mailman/options/antlr-interest/your-email-address</a>
      </pre>
    </blockquote>
    <pre wrap="">
List: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/listinfo/antlr-interest">http://www.antlr.org/mailman/listinfo/antlr-interest</a>
Unsubscribe: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/options/antlr-interest/your-email-address">http://www.antlr.org/mailman/options/antlr-interest/your-email-address</a>
    </pre>
  </blockquote>
  <pre wrap=""><!---->

List: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/listinfo/antlr-interest">http://www.antlr.org/mailman/listinfo/antlr-interest</a>
Unsubscribe: <a class="moz-txt-link-freetext" href="http://www.antlr.org/mailman/options/antlr-interest/your-email-address">http://www.antlr.org/mailman/options/antlr-interest/your-email-address</a>
  </pre>
</blockquote>
<br>
</body>
</html>