Plugin Documentation

Goals available for this plugin:

GoalReport?Description
javadoc:aggregateYesGenerates documentation for the Java code in an aggregator project using the standard Javadoc Tool.
javadoc:aggregate-jarNoBundles the Javadoc documentation for main Java code in an aggregator project into a jar using the standard Javadoc Tool.
javadoc:fixNoFix Javadoc documentation and tags for the Java code for the project. See Where Tags Can Be Used.
javadoc:helpNoDisplay help information on maven-javadoc-plugin.
Call mvn javadoc:help -Ddetail=true -Dgoal=<goal-name> to display parameter details.
javadoc:jarNoBundles the Javadoc documentation for main Java code in an NON aggregator project into a jar using the standard Javadoc Tool.
javadoc:javadocYesGenerates documentation for the Java code in an NON aggregator project using the standard Javadoc Tool.
javadoc:resource-bundleNoBundle AbstractJavadocMojo.javadocDirectory, along with javadoc configuration options such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself.
javadoc:test-aggregateYesGenerates documentation for the Java Test code in an aggregator project using the standard Javadoc Tool.
javadoc:test-aggregate-jarNoBundles the Javadoc documentation for Java Test code in an aggregator project into a jar using the standard Javadoc Tool.
javadoc:test-fixNoFix Javadoc documentation and tags for the Test Java code for the project. See Where Tags Can Be Used.
javadoc:test-jarNoBundles the Javadoc documentation for test Java code in an NON aggregator project into a jar using the standard Javadoc Tool.
javadoc:test-javadocYesGenerates documentation for the Java Test code in an NON aggregator project using the standard Javadoc Tool.
javadoc:test-resource-bundleNoBundle TestJavadocJar.testJavadocDirectory, along with javadoc configuration options from AbstractJavadocMojo such as taglet, doclet, and link information into a deployable artifact. This artifact can then be consumed by the javadoc plugin mojos when used by the includeDependencySources option, to generate javadocs that are somewhat consistent with those generated in the original project itself.

System Requirements

The following specifies the minimum requirements to run this Maven plugin:

Maven2.2.1
JDK1.5
MemoryNo minimum requirement.
Disk SpaceNo minimum requirement.

Usage

You should specify the version in your project's plugin configuration:

<project>
  ...
  <build>
    <!-- To define the plugin version in your parent POM -->
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>2.9.1</version>
        </plugin>
        ...
      </plugins>
    </pluginManagement>
    <!-- To use the plugin goals in your POM or parent POM -->
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9.1</version>
      </plugin>
      ...
    </plugins>
  </build>
  ...
  <!-- To use the report goals in your POM or parent POM -->
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2.9.1</version>
      </plugin>
      ...
    </plugins>
  </reporting>
  ...
</project>

For more information, see "Guide to Configuring Plug-ins"