JDK-8020688 : broken links in documentation at http://docs.oracle.com/javase/6/docs/api/index.
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.awt
  • Affected Version: 6u45,7u25,8
  • Priority: P2
  • Status: Closed
  • Resolution: Fixed
  • OS: windows_7
  • Submitted: 2013-07-01
  • Updated: 2022-02-22
  • Resolved: 2013-10-04
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 8 Other
8 b112Fixed openjdk7uFixed
Related Reports
Duplicate :  
Duplicate :  
Duplicate :  
Relates :  
Description
FULL PRODUCT VERSION :


A DESCRIPTION OF THE PROBLEM :
Most pages have a link to  " http://bugs.sun.com/services/bugreport/index.jsp " ,  which should be fixed,  since you probably wont be having sun.com redirecting forever.  Most pages have a link to  " http://java.sun.com/javase/6/webnotes/devdocs-vs-specs.html " ,  which should be fixed for the same reason.

The page  " http://docs.oracle.com/javase/6/docs/api/index.html?java/util/Scanner.html "  has a link to  " http://java.sun.com/docs/books/tutorial/post1.0/ui/keylistener.html " ,  which is really broken.   I think that it should lead to  " http://docs.oracle.com/javase/tutorial/uiswing/events/keylistener.html " ,  but I'm not sure of that.


REPRODUCIBILITY :
This bug can be reproduced always.
Comments
Verified selectively. Links in docs are correct.
07-11-2013

URL: http://hg.openjdk.java.net/jdk8/jdk8/jdk/rev/6ffe50fe06bd User: lana Date: 2013-10-11 18:24:46 +0000
11-10-2013

URL: http://hg.openjdk.java.net/jdk8/awt/jdk/rev/6ffe50fe06bd User: mcherkas Date: 2013-10-04 16:16:18 +0000
04-10-2013

broken links are not P4. And it *is* product bug as our product includes documentation
25-07-2013

isn't critical to update releases (P4)
24-07-2013

This is not a product bug, so I don't see any reasons for having it P3. In general, we can't change JavaDoc in update releases, but this case is not a specification change, it's a wrong link. Links, typos, formatting, etc. can be fixed in update releases, but it should be fixed in 8 first anyway.
24-07-2013

I don't see a broken link to "...../tutorial/post1.0/ui/keylistener.html" in http://docs.oracle.com/javase/7/docs/api/index.html?java/util/Scanner.html
24-07-2013

The first part of the bug, which is the link to report a bug is already fixed with the JDK7 documentation. The part to fix for this bug is about the tutorial.
23-07-2013

Per Michel/Jeannette, needs AWT change in http://opengrok.ie.oracle.com:8080/opengrok/xref/jdk6-cpu/j2se/src/share/classes/java/awt/event/KeyListener.java so this points to the correct tutorial. Need to change other inappropriate links also. Move to a P4, and will assign someone to review/resolve.
23-07-2013

I talked to Michel and he agreed it wasn't a build issue. Back to awt...
23-07-2013

This is a build issue. The string to the submit a bug website is in a makefile.
23-07-2013

I closed this bug too quickly. There are two issues in this bug: 1. The broken link to Tutorial: Writing a Key Listener in the KeyListener interface Javadoc 2. The link to Submit a Bug or Enhancement Issue #1 needs to be fixed. For issue #1, this needs to be fix in the Java SE 6, 7, and 8 Javadoc. For issue #2, the redirect works correctly, so nothing is broken.
18-07-2013

The documentation team does not fix bugs for Java SE 6. In the JDK 7 Javadoc, the link to the Submit a Bug or Feature goes to http://bugreport.sun.com/bugreport/ http://docs.oracle.com/javase/7/docs/api/index.html?java/util/Scanner.html
18-07-2013

Needs Docs Team (and possibly Nelson, Community Team) to resolve.
18-07-2013