Plugin Usage How do I use links ?

The URLs must link to a directory where the javadoc generated file "package-list" is accesible for the package.

Example:

maven.javadoc.links=http://java.sun.com/j2se/1.4.2/docs/api/, http://maven.apache.org/apidocs/ How do I use offlineLinks ?

The URLs must link to a directory where the javadoc generated file "package-list" is accesible for the package.

Example (generates offline links in offline mode):

maven.javadoc.offlineLinks=/opt/java-apidoc/j2sdk1.4.1/docs/api/, /cvsroot/maven/target/docs/apidocs/

Generation of online javadoc links in offline mode is also possible. You need to provide the online URL plus the a offline directory resource for "package-list". URL and directory need to be seperated by the "#" character.

Example (generates online links in offline mode):

maven.javadoc.offlineLinks= \ http://java.sun.com/j2se/1.4.2/docs/api/#/opt/java-apidoc/j2sdk1.4.1/docs/api/, \ http://maven.apache.org/apidocs/#/cvsroot/maven/target/docs/apidocs/ How do I use links behind a Firewall ?

You can set your proxy parameters in the additionnal parameters passed to the javadoc :

maven.javadoc.additionalparam=-J-DproxyHost=${maven.proxy.host} -J-DproxyPort=${maven.proxy.port} How do I generate class diagrams on Javadoc pages using free tools ?

One solution is to use UMLGraph and dot (part of Graphviz).

When running the javadoc goal with the below configuration, the UmlGraphDoc doclet generates class diagrams into the package and class pages.

  1. Put latest jar in repo/depend on UmlGraph jar, e.g.
    2. gr.spinellis UmlGraph 4.6 ]]>
  2. Set Maven properties:
    3. maven.javadoc.doclet=gr.spinellis.umlgraph.doclet.UmlGraphDoc maven.javadoc.docletpath=${maven.repo.local}/gr.spinellis/jars/UmlGraph-4.6.jar maven.javadoc.usestandardparameters=true

    Maven Javadoc plugin version 1.9 and newer enables specifying custom doclet parameters. This makes configuring UMLGraph's doclet possible, for example, turning on extra class diagram adornments. Adjust these as desired, referring to the UMLGraph documentation.

    maven.javadoc.doclet.param.list=umlgraph.all umlgraph.all.name=-all
  3. Install dot (in Graphviz) and put on PATH (so UmlGraphDoc can run it); e.g. for Windows:
    4. GRAPHVIZ_HOME=(the path) PATH=%PATH%;%GRAPHVIZ_HOME%\bin

    Note that UmgGraphDoc outputs an error message if it could not run dot.

Refer to UMLGraph docs for its custom Javadoc tags that enhance the generated diagrams.