I have no idea of this is on ongoing fix, but I am sure many of you 
should have faced this problem:

The Javadocs task in build.xml will not work with JDK 1.4 because of the 
"java" in package names. This is an open bug in 1.4 Final according to 
Sun, http://developer.java.sun.com/developer/bugParade/bugs/4507380.html.

The workaround, as listed on the page is to use the -subpackages option 
in javadoc, the final task that works, for me is:

<target name="javadocs" depends="setenv" unless="javadoc.notrequired">
    <mkdir dir="${build.javadocs}"/>
    <javadoc packagenames="javax.*"
             sourcepath="${src.dir}"
             classpathref="classpath"
             destdir="${build.javadocs}"
             author="true"
             version="true"
             use="true"
             windowtitle="${Name} API"
             doctitle="${Name}"
             additionalparam="-subpackages org"
             bottom="Copyright &#169; ${year} Apache XML Project. All 
Rights Reserved."
    />
  </target>

Any idea is this or an equivalent is expected to be checked in anytime soon?

Mukund Balasubramanian

Reply via email to