I've attached a small patch to the build.xml for the collections project to
improve the JavaDoc generation.

Firstly specifying classpath caused the JavaDoc not to work on my win2000
box. I'm not sure if this is an Ant version issue but removing it seemed to
work fine.

Secondly adding the following line to the JavaDoc task causes all JDK types
to be linked in the resultant javadoc, allowing users to navigate through
into the JDK.

    <javadoc ...>
      <link href="http://java.sun.com/products/jdk/1.3/docs/api"/>

    </javadoc>

If there was a standard javadoc installation on, say, jakarta.apache.org for
all the jakarta projects and jakarta-commons projects, we could all do
similar things on other projects so that all our JavaDoc links together.

James
Index: build.xml
===================================================================
RCS file: /home/cvspublic/jakarta-commons/collections/build.xml,v
retrieving revision 1.4
diff -b -u -r1.4 build.xml
--- build.xml   2001/04/22 17:05:03     1.4
+++ build.xml   2001/04/29 10:54:54
@@ -138,7 +138,6 @@
       <mkdir dir="${dest.doc.api}"/>
       <javadoc packagenames="org.*"
                sourcepath="${workdir}"
-               classpath="${classpath}"
                destdir="${dest.doc.api}"
                windowtitle="${Name-Long}"
                doctitle="${Name-Long}"
@@ -154,6 +153,7 @@
                nohelp="true"
                nonavbar="false"
                serialwarn="false">
+      <link href="http://java.sun.com/products/jdk/1.3/docs/api"/>
       </javadoc>
       <delete dir="${workdir}"/>
    </target>

Reply via email to