use google's doclava for generating javadoc (better looking look and feel, with search capabilities)

pom.xml

@@ -308,9 +308,26 @@
         <artifactId>maven-javadoc-plugin</artifactId>
         <version>${plugin.javadoc.version}</version>
         <configuration>
-          <links>
+          <docletArtifact>
-            <link>http://download.oracle.com/javase/6/docs/api/</link>
+            <groupId>com.google.doclava</groupId>
-          </links>
+            <artifactId>doclava</artifactId>
+            <version>1.0.3</version>
+          </docletArtifact>
+          <doclet>com.google.doclava.Doclava</doclet>
+          <!-- bootclasspath required by Sun's JVM -->
+          <bootclasspath>${sun.boot.class.path}</bootclasspath>
+          <additionalparam>
+             -quiet
+             -federate JDK http://download.oracle.com/javase/6/docs/api/index.html?
+             -federationxml JDK http://doclava.googlecode.com/svn/static/api/openjdk-6.xml
+             -hdf project.name "${project.name}"
+             -d .
+             -hide 101
+             -proofread ./proof-read.txt
+          </additionalparam>
+          <useStandardDocletOptions>false</useStandardDocletOptions>
+          <!-- Apple's JVM sometimes requires more memory -->
+          <additionalJOption>-J-Xmx1024m</additionalJOption>
         </configuration>
       </plugin>
       <plugin>

src/main/java/org/rundeck/api/RundeckClient.java

@@ -61,7 +61,7 @@ import org.rundeck.api.util.ParametersUtil;
  * <br>
  * Usage : <br>
  * <code>
- * <pre>
+ * <pre class="prettyprint">
  * // using login-based authentication :
  * RundeckClient rundeck = new RundeckClient("http://localhost:4440", "admin", "admin");
  * // or for a token-based authentication :