Name: rmT116609 Date: 12/02/2002
FULL PRODUCT VERSION :
java version "1.4.1_01"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_01-b01)
Java HotSpot(TM) Client VM (build 1.4.1_01-b01, mixed mode)
FULL OPERATING SYSTEM VERSION : WIndows NT v4.0, SP6
A DESCRIPTION OF THE PROBLEM :
The javadoc tool's "-linkoffline" does not work as
advertised. Here's a simple example of trying to link to
the external JDK javadocs:
javadoc -d myJavadocs -sourcepath java-src -linkoffline
http://java.sun.com/j2se/1.4.1/docs/api D:\j2sdk1.4.1_01
\docs\api -subpackages com.hcsc
I have the "package-list" file for the JDK sitting
at "D:\j2sdk1.4.1_01\docs\api".
The javadoc tool runs with no errors but produces incorrect
links (in some places) to the external JDK documentation.
Now, if I load the generated "overview-tree.html" file, all
links to the external javadoc are generated correctly. For
example, I can click on a click to java.lang.Object and it
takes me to Sun's site. This is the part that works as it
should.
On the other hand, if I look at the javadocs for any of my
classes and I click on the "java.lang.Object" link (which
is, of course, the superclass of all my classes), the link
is broke. It seems the link points to:
<A
HREF="../../../../../../http://java.sun.com/j2se/1.4.1/docs/
api/java/lang/Object.html">java.lang.Object</A>
The same problem happens with links in parameters to
methods. For example, if I have a method that takes String
parameter, the link to the String documentation is broke.
REPRODUCIBILITY :
This bug can be reproduced always.
(Review ID: 178411)
======================================================================