Added some documentation, change the version number on v3 lib. Added Sam to the license.

This commit is contained in:
Terence Parr 2012-09-18 11:25:06 -07:00
parent 046402b00e
commit 54673f4675
4 changed files with 87 additions and 7 deletions

View File

@ -1,5 +1,5 @@
[The "BSD license"] [The "BSD license"]
Copyright (c) 2011 Terence Parr Copyright (c) 2012 Terence Parr, Sam Harwell
All rights reserved. All rights reserved.
Redistribution and use in source and binary forms, with or without Redistribution and use in source and binary forms, with or without

View File

@ -1,4 +1,4 @@
ANTLR v4 early access ANTLR v4
Terence Parr, parrt at cs usfca edu Terence Parr, parrt at cs usfca edu
ANTLR project lead and supreme dictator for life ANTLR project lead and supreme dictator for life
@ -6,4 +6,84 @@ University of San Francisco
INTRODUCTION INTRODUCTION
Coming soon... Hi and welcome to the Honey Badger 4.0b1 release of ANTLR!
INSTALLATION
$ cd /usr/local/lib
$ curl -O --silent http://www.antlr.org/download/antlr-4.0b1-complete.jar
Or just download from http://www.antlr.org/download/antlr-4.0b1-complete.jar
and put it somewhere rational for your operating system.
You can either add to your CLASSPATH:
$ export CLASSPATH=".:/usr/local/lib/antlr-4.0b1-complete.jar:$CLASSPATH"
and launch org.antlr.v4.Tool directly:
$ java org.antlr.v4.Tool
ANTLR Parser Generator Version 4.0b1
-o ___ specify output directory where all output is generated
-lib ___ specify location of .tokens files
...
or use -jar option on java:
$ java -jar /usr/local/lib/antlr-4.0b1-complete.jar
ANTLR Parser Generator Version 4.0b1
-o ___ specify output directory where all output is generated
-lib ___ specify location of .tokens files
...
You can make a script, /usr/local/bin/antlr4:
#!/bin/sh
java -cp "/usr/local/lib/antlr4-complete.jar:$CLASSPATH" org.antlr.v4.Tool $*
On Windows, you can do something like this (assuming you put the
jar in C:\libraries) for antlr4.bat:
java -cp C:\libraries\antlr-4.0-complete.jar;%CLASSPATH% org.antlr.v4.Tool %*
You can also use an alias
$ alias antlr4='java -jar /usr/local/lib/antlr-4.0-complete.jar'
Either way, say just antlr4 to run ANTLR now.
The TestRig class is very useful for testing your grammars:
$ alias grun='java org.antlr.v4.runtime.misc.TestRig'
EXAMPLE
In /tmp/Hello.g4, paste this:
// Define a grammar called Hello
// match keyword hello followed by an identifier
// match lower-case identifiers
grammar Hello;
r : 'hello' ID ;
ID : [a-z]+ ;
WS : [ \t\n]+ -> skip ; // skip spaces, tabs, newlines
Then run ANTLR the tool on it:
$ cd /tmp
$ antlr4 Hello.g4
$ javac Hello*.java
Now test it:
$ grun Hello r -tree
hello parrt
^D
(r hello parrt)
(That ^D means EOF on unix; it's ^Z in Windows.) The -tree option prints
the parse tree in LISP notation.
BOOK SOURCE CODE
http://pragprog.com/titles/tpantlr2/source_code

View File

@ -1,4 +1,4 @@
version=4.0b1 version=4.0b1
antlr3.jar=/usr/local/lib/antlr-3.4-complete.jar antlr3.jar=/usr/local/lib/antlr-3.5-complete.jar
build.sysclasspath=ignore build.sysclasspath=ignore

View File

@ -4,9 +4,9 @@
Make build.properties like this: Make build.properties like this:
version=4.0ea version=4.0b1
antlr3.jar=/usr/local/lib/antlr-3.4-complete.jar antlr3.jar=/usr/local/lib/antlr-3.5-complete.jar
build.sysclasspath=ignore build.sysclasspath=ignore
--> -->