JDK-4786972 : -linkoffline works only partially
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.1
  • Priority: P3
  • Status: Closed
  • Resolution: Duplicate
  • OS: windows_nt
  • CPU: x86
  • Submitted: 2002-12-02
  • Updated: 2014-05-05
  • Resolved: 2002-12-02
Related Reports
Duplicate :  
Description

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

Comments
EVALUATION 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. ###@###.### 2002-12-02
02-12-2002