Installation

The plugin has not been pushed to the official Maven repositories yet, so you will need to add the maven-antlr3-plugin repository to your plugin repositories list. Add the following to your project's POM,

<project>
  ...
  <pluginRepositories>
    <pluginRepository>
      <id>bif-repository</id>
      <url>http://maven.badgers-in-foil.co.uk/maven2/</url>
    </pluginRepository>
  </pluginRepositories>
  ...
</project>

Getting ANTLR v3

Until the final release of ANTLR 3, and its appearence in the Maven repositories you will need to grab a snapshot and install into your local repository.

Download the ANTLR 3 snapshot version matching this project's antlr-tool dependancy (as listed in dependancies) from,

http://www.antlr.org/download/build/

On unpacking the .tar.gz file, you should find antlr-$version.jar and runtime-$version.jar files in the resulting lib subfolder. These should be installed into your repository with the Maven install-file command, using the POM metadata provided below.

For the tool jar (replace $version with the appropriate value),

mvn install:install-file -DgroupId=org.antlr -DartifactId=antlr-tool -Dversion=${version} -Dpackaging=jar -DpomFile=tool.pom -Dfile=lib/antlr-${version}.jar

For the Java runtime jar (replace $version with the appropriate value),

mvn install:install-file -DgroupId=org.antlr -DartifactId=antlr-java-runtime -Dversion=${version} -Dpackaging=jar -DpomFile=runtime.pom -Dfile=lib/runtime-${version}.jar

POM metadata for ANTLR

When installing ANTLR, please use the following Project Object Models,

tool.pom:

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>org.antlr</groupId>
  <artifactId>antlr-tool</artifactId>
  <packaging>jar</packaging>
  <version>05-14-2007.17</version>

  <dependencies>
    <dependency>
      <groupId>org.antlr</groupId>
      <artifactId>stringtemplate</artifactId>
      <version>3.0</version>
    </dependency>
    <dependency>
      <groupId>antlr</groupId>
      <artifactId>antlr</artifactId>
      <version>2.7.7</version>
    </dependency>
  </dependencies>
</project>

runtime.pom

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>org.antlr</groupId>
  <artifactId>antlr-java-runtime</artifactId>
  <packaging>jar</packaging>
  <version>05-14-2007.17</version>
</project>

See usage instructions.