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
  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

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