How do I rebuild ANTLR v3?
Just run ant from the main directory where you see the build.xml file. Use the build target:
ant build
Or, for old people like Terence, you can do the following. Make sure the following two jars are in your CLASSPATH
antlr-3.0/lib/stringtemplate-3.0.jar
antlr-3.0/lib/antlr-2.7.7.jar
then jump into antlr-3.0/src directory and then type:
$ javac -d . org/antlr/Tool.java org/antlr/*/*.java org/antlr/*/*/*.java
Takes 9 seconds on my 1Ghz laptop or 4 seconds with jikes. Later I'll have a real build mechanism, though I must admit the one-liner appeals to me. I use Intellij so I never type anything actually to build.
Actually, this won't rebuild the grammars. If you touch the grammars, you need to convert all those Java:
cd antlr-3.0/src/org/antlr/tool
java antlr.Tool antlr.g
java antlr.Tool antlr.print.g
java antlr.Tool assign.types.g
java antlr.Tool define.g
java antlr.Tool buildnfa.g
cp ANTLRTokenTypes.txt ../codegen
pushd ../codegen; java antlr.Tool codegen.g; popd
That is for the v2-based grammars. There are actually two v3 grammars written in v3. Don't mess with them until I can rebuild all grammars in v3.
Comments
Hamilton Link sent to interest-list:
OK, I can build 3.1b1 from the distro now. For those of you who are Java-illiterate like me, let me briefly clarify a few things:
*In general when compiling java stuff you want to pass javac a -classpath argument enumerating the jar files of interest, don't set a CLASSPATH variable for your entire shell (usually).
If you're building it under Mac OS X or *nix, your classpath separator character is ':' and under windows it is ';' — and annoyingly, using a ';' under OS X doesn't error out, it just... ignores the classpath you're providing, so you get "package so.and.so does not exist" errors for stuff you thought you pointed to.
Less obviously, to build antlr 3.1b1, you need one jar beyond what http://www.antlr.org/wiki/pages/viewpage.action?pageId=732
says (and note the comment added one beyond what the original page had). Your classpath must include the following four jar files:
${ANTLRLIB}/antlr-2.7.7.jar
${ANTLRLIB}/stringtemplate-3.1.jar
${ANTLRLIB}/junit-4.4.jar
${ANTLRLIB}/antlr-runtime-3.1b1.jar
And no, junit-4.4.jar is not provided in the distribution, you need to get it from sourceforge. gunit's not the same thing (as it turns out).
And there's no such thing as org/antlr///*.java in the distribution (presumably because we're provided the jar files instead), so I am setting an ANTLR_CP variable to the above list and compiling with the following command within antlr-3.1b1/src:
javac -verbose -classpath ${ANTLR_CP} -d . org/antlr/Tool.java org/antlr/*/*.java
Now that I can do this much, we'll see if I can rebuild targets, .net runtime assemblies, or the jar files provided in antlr-3.1b1/lib. I am guessing not, as there appears to be code to these jar files that doesn't come with the snapshots. Perhaps someone in the know can clarify what having the snapshots (vs. the exhaustive sources) does and does not let us build from scratch?
I think, also, that it would be friendly if someone could go and update the "how to rebuild antlr" web page at http://www.antlr.org/wiki/pages/viewpage.action?pageId=732 ... it's not hugely out of date but it is a little bit out of date, and it would be nice if that page made it clear what you are rebuilding and what you can't rebuild without additional code not provided in the snapshots.
I was able to build antlr with ant by following the instructions on this page plus two steps.
Prior to invoking ant build:
ensure that ant's "optional tasks" are installed (http://ant.apache.org/manual/install.html#optionalTasks)
download junit 4.4 and place it in the "lib" directory (http://downloads.sourceforge.net/junit/junit-4.4.jar)
In my C#-ish environment, simply typing "ant build" does not work immediately. Rather, I have to do the following:
First, going to the root directory (where build.xml resides) and running ANT results in
C:\MyProjects\ANTLR3Explanations\antlr-2007-12-27.12>ant
Buildfile: build.xml
generator-prepare:
generator:
[antlr] java.lang.NoClassDefFoundError: antlr/Tool
[antlr] Exception in thread "main"
This can be corrected by setting the CLASSPATH explicitly (I assume here that you run ANT from the top-level untar directory):
set ANTLRLIB=.\lib
set CLASSPATH=%ANTLRLIB%\stringtemplate-3.1b1.jar;%ANTLRLIB%\antlr-2.7.7.jar;C:\eclipse\plugins\org.junit_3.8.1\junit.jar
where junit points to some arbitrary junit installation. Running ANT now will now produce a host of "duplicate class" errors:
[myjavac] C:\MyProjects\ANTLR3Explanations\antlr-2007-12-27.12\codegen\ANTLRLexer.java:61: duplicate class: org.antlr.tool.ANTLRLexer
[myjavac] public class ANTLRLexer extends antlr.CharScanner implements ANTLRTokenTypes, TokenStream
...etc. (13 such messages)
At this point, it is necessary to remove the "codegen.dir" from the sources to be compiled. This is done by removing (or commenting) the line
<pathelement location="${codegen.dir}" />
in the build.xml file (line 36 in the current build). Now, the compile will work (interestingly, after this, it is possible to re-insert the line; because of the lazy compile, everything will work fine from then on, it seems).