JDK-6413228 : Many links broken with "?is-external=true".
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 6
  • Priority: P2
  • Status: Closed
  • Resolution: Duplicate
  • OS: generic
  • CPU: generic
  • Submitted: 2006-04-14
  • Updated: 2014-05-05
  • Resolved: 2006-06-10
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 6
6Resolved
Related Reports
Duplicate :  
JDK-6416095 - Change docs structures to support efficient work processes
Relates :  
JDK-4855876 - JavaScript error (bug 4645058) still exists in IE 6
Description
Some links within javadoc pages contain "?is-external=true", which works
fine with some web servers but doesn't work at all with others.  java.sun.com
is an example of the latter.

Example:
Go here
  http://java.sun.com/javase/6/docs/guide/javadoc/doclet/spec/com/sun/javadoc/Doc.html
and click on the "Comparable" link near the top of the page.
Comments
EVALUATION The latest Mustang docs online at mustang.dev.java.net appear to have this problem solved. See for example the Comparable links in http://download.java.net/jdk6/docs/jdk/api/javadoc/doclet/com/sun/javadoc/Doc.html
07-06-2006
EVALUATION Disregard the above: is-external isn't to blame. While the "?is-external=true" links are failing on java.sun.com -- it's not the query string that's causing the problem. The problem is that the links point to the wrong location. To see this, go to http://java.sun.com/javase/6/docs/guide/javadoc/doclet/spec/com/sun/javadoc/Doc.html and click on the "Comparable" link near the top of the page. It doesn't work. Until just now I thought it was the query string that caused the problem, since the query string was right there with all the bad links and LinkCheck was complaining. But in fact if you look at the URL you're directed to, it's this: http://java.sun.com/javase/6/docs/guide/api/java/lang/... while it should be this: http://java.sun.com/javase/6/docs/api/java/lang/... The actual HTML is: <a href="../../../../../../api/java/lang/Comparable.html?is-external=true" which works fine with the way the various directories are laid out on our internal server, but isn't correct for the layout on java.sun.com.
17-04-2006
EVALUATION The files with 4855876 in their SCCS histories are: src/share/classes/com/sun/tools/doclets/formats/html/HtmlDocletWriter.java src/share/classes/com/sun/tools/doclets/formats/html/markup/HtmlWriter.java A big grep for "is-external" in the doclet source code turns up those same two files.
14-04-2006
SUGGESTED FIX .
14-04-2006
EVALUATION This regression was introduced by the fix for 4855876.
14-04-2006