JDK APT + Maven2
================

1) Build the Maven2 compiler extension here (note, this isn't a Maven2 plugin.  yet.) using:

   mvn clean compile

2) Install the plugin to your local Maven2 repository:

  mvn install

To use the APT compiler plugin from a Maven2 POM, the compiler plugin needs to be registered with the POM
as a dependency.  For example:

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <compilerId>apt</compilerId>
                    <source>1.5</source>
                    <target>1.5</target>
                    <fork>true</fork>
                    <verbose>true</verbose>
                    <compilerArguments>
                        <s>target/srcgen</s>
                    </compilerArguments>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.apache.beehive</groupId>
                        <artifactId>beehive-compiler-apt</artifactId>
                        <version>1.0-SNAPSHOT</version>
                        <scope>runtime</scope>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>

To pass arguments to APT via the -A command line options, add elements like this:

    <APTweb.content.root>src/main/webapp</APTweb.content.root>

to the <compilerArguments> section of the <configuration> element for the compiler.  
This example is the equivalent of passing this on the command line:

  -Aweb.content.root=src/main/webapp

Known APT compiler plugin limitations:
- the "fork" mode doesn't work
- a POM should manually specify the "-s" option to set the output directory for generated files