Apache

Docs Plugins

Javadoc Plugin 3.12.0 · Other versions

The Apache Maven Javadoc Plugin is a plugin that uses the javadoc tool for generating javadocs for the specified project.

Source
Edit this page
Wrong?
Report a problem

Using Alternate Doclet

To generate output from an alternate doclet, add configuration similar to the following to your POM.

In this example, the doclet is UmlGraph (https://www.spinellis.gr/umlgraph/). UmlGraph allows the declarative specification and drawing of UML class and sequence diagrams.

Note about UmlGraph: You must have the Graphviz binary in your PATH, or the images will not be generated. For more information about Graphviz, please refer to http://www.graphviz.org/.

Error during retrieving content skip as ignoreDownloadError activated.

Note:

After executing mvn site, you will see that a UML graph (.dot file) will be generated in the destination directory.

Using Alternate Doclet In Addition To The Javadoc Doclet

To generate output from an alternate doclet in addition to the normal HTML Javadoc doclet, add configuration similar to the following to your POM.

In this example, the doclet is Sun DocCheck (http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html/). The Sun Doc Check Doclet is an extension to the Javadoc tool. It runs on source code and reviews documentation comments, generating an HTML report that identifies empty comments and other omissions and irregularities in the documentation comments.

<project>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>3.12.0</version>
        <reportSets>
          <reportSet>
            <id>html</id>
            <reports>
              <report>javadoc</report>
            </reports>
          </reportSet>
          <reportSet>
            <id>doccheck</id>
            <configuration>
              <doclet>com.sun.tools.doclets.doccheck.DocCheck</doclet>

              <!-- <docletPath>/path/to/doccheck.jar</docletPath> -->
              <docletArtifact>
                <groupId>com.sun.tools.doclets</groupId>
                <artifactId>doccheck</artifactId>
                <version>1.2b2</version>
              </docletArtifact>
              <additionalOptions>
                <additionalOption>-d</additionalOption>
                <additionalOption>${project.build.directory}/site/doccheck</additionalOption>
              </additionalOptions>

              <!-- For the project-reports page-->
              <name>DocCheck</name>
              <description>DocCheck documentation.</description>
            </configuration>
            <reports>
              <report>javadoc</report>
            </reports>
          </reportSet>
        </reportSets>
      </plugin>
      ...
    </plugins>
  </reporting>
  ...
</project>