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

N/A

This is a known bug:

  4720957: -link and -linkoffline creates wrong link to ../../../http://

  which is on bug parade at:
  http://developer.java.sun.com/developer/bugParade/bugs/4720957.html

This bug has been fixed for 1.4.2.
Closing out as a duplicate.
Please re-submit if 1.4.2 does not fix this problem.
  xxxxx@xxxxx   2002-12-02