JDK-4210180 : Javadoc 1.1 creates broken links outside the package
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.1.6
  • Priority: P4
  • Status: Closed
  • Resolution: Won't Fix
  • OS: generic
  • CPU: generic
  • Submitted: 1999-02-09
  • Updated: 2014-05-05
  • Resolved: 2000-02-22
Related Reports
Relates :  
Description

Name: js5519			Date: 02/09/99


Using javadoc for a package, have a class extending from 
java.io.PrintWriter and overloading one of its methods (e.g. close()).

Run javadoc on the package without including the JDK packages. The resulting
HTML document will have text indicating that the close() method
overrides the close() method on class java.io.PrintWriter and will
have a broken hyper link to java.io.PrintWriter#close().

The link is broken because the JDK documentation was not produced as part of the 
generated documentation. JDK 1.1 indicates that such outside links
should not be generated by javadoc.


(Review ID: 52547)
======================================================================
attached is the source file where the problem appears. We are running
Javadoc as follows:

    mkdir -p jdoc oracle/oas/jco
    cp Logger.java oracle/oas/jco
    javadoc -public -d jdoc oracle.oas.jco

The result is the attached html file which contains a link to
java.io.PrintWriter.html#close(). That link should not be there.

Please let me know the correct bug tracking ID because the one recieved
from the auto-response does not seem to work. I need to put the correct
reference in our own bug tracking system.

Thanks in advance,

Jose Alberto

john.stampfl@eng 1999-02-09 - I tried to attach the Logger.java file and 
the generated html file.  If you can't access these files, email me.


Comments
EVALUATION I am investigating this. atul.dambalkar@eng 1999-02-10 The 1.1 doclet has been removed from Merlin, this bug is now mute. Will not fix. robert.field@Eng 2000-02-21
10-02-1999