[Swift-devel] Log processing and language reference documentation

[Michael Wilde]

I vote for including the log doc in the user guide.

- Mike

----- Original Message -----
> From: "David Kelly" <davidk at ci.uchicago.edu>
> To: "Justin M Wozniak" <wozniak at mcs.anl.gov>
> Cc: swift-devel at ci.uchicago.edu, "Michael Wilde" <wilde at mcs.anl.gov>
> Sent: Wednesday, August 24, 2011 3:25:27 PM
> Subject: Re: [Swift-devel] Log processing and language reference documentation
> Thanks Justin. I will remove references to the older guide and use the
> one you mentioned. I'll copy the document to
> swift/docs/log-processing/log-processing.txt so it can become a part
> of the nightly build process.
> 
> David
> 
> ----- Original Message -----
> > From: "Justin M Wozniak" <wozniak at mcs.anl.gov>
> > To: "Michael Wilde" <wilde at mcs.anl.gov>
> > Cc: "David Kelly" <davidk at ci.uchicago.edu>,
> > swift-devel at ci.uchicago.edu
> > Sent: Wednesday, August 24, 2011 3:02:47 PM
> > Subject: Re: [Swift-devel] Log processing and language reference
> > documentation
> > >> I was just wondering if the log processing documentation on the
> > >> website is up to date?
> > >
> > > Justin and any users of the log tools, can you comment?
> >
> > All of the log-processing scripts that I know how to use are
> > documented
> > in:
> >
> > swift/libexec/log-processing/README.txt
> >
> > This is an asciidoc-formatted file.
> >
> > >> Also, is there any place to get an up to date list of swift
> > >> reserved
> > >> words? It took me a few minutes to figure out why my swift code
> > >> wasn't
> > >> compiling. I had named a variable 'in' and it was conflicting
> > >> with
> > >> the
> > >> 'in' used by foreach.
> > >
> > > That would be good to state in the user guide. Mihael, Justin, or
> > > Ben,
> > > can you comment on this based on your knowledge of the parser? Is
> > > this
> > > encoded into an ANTLR spec that can be translated into a user
> > > guide
> > > table?
> >
> > I just took another look at swiftscript.g and I don't think there is
> > an
> > easy way to automate this.
> >
> > Justin
> >
> > --
> > Justin M Wozniak

-- 
Michael Wilde
Computation Institute, University of Chicago
Mathematics and Computer Science Division
Argonne National Laboratory