Bug ID: JDK-8041728 Java API documentation, class BorderFactory (and others)

Type: Bug
Component: client-libs
Affected Version: 7u55,8u5,9

Priority: P4
Status: Open
Resolution: Unresolved
OS: windows_vista

Submitted: 2013-08-26
Updated: 2021-07-13

Other
tbdUnresolved

A DESCRIPTION OF THE PROBLEM :
Why do  many of the links in the Java API to the Java Tutorial actually point to java.sun.com?

On the BorderFactory page of the API, we find:
"For further information and examples see How to Use Borders, a section in The Java Tutorial."

"How to Use Borders points to here:
java.sun.com/docs/books/tutorial/uiswing/misc/border.html

"How to Use Borders" is actually here: http://docs.oracle.com/javase/tutorial/uiswing/components/border.html

There are many other instances of this problem.  Some links to the tutorials work, many do not.  This  is very frustrating for a new programmer.  I have to go to the tutorial index page and start hunting around for what I want.

This should be a simple fix.  Joseph Harrington

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -


http://docs.oracle.com/javase/tutorial/uiswing/components/border.html


ACTUAL -
java.sun.com/docs/books/tutorial/uiswing/misc/border.html


URL OF FAULTY DOCUMENTATION :
http://docs.oracle.com/javase/7/docs/api/index.html

http://cr.openjdk.java.net/~malenkov/8041728.9.0/
23-05-2014
Large chunk of broken links was fixed in jdk8
28-04-2014
BTW: I've done grep only for 'href="http://java.sun.com '
24-04-2014
I think this should be fixed in all public versions: 9,8 and 7
24-04-2014
- 404 means that 404 http response is received -m means that the request is redirected to main Orache java tech page: http://www.oracle.com/technetwork/java/index.html Under each broken link there is a list of files where this link has been found.
24-04-2014
Here is the list of broken links in javadoc across all classes in the jdk7u-dev/jdk/src/classes: -m http://java.sun.com/Series/Tutorial/index.html ./javax/swing/JList.java ./javax/swing/JComboBox.java -m http://java.sun.com/developer/Books/JDBCTutorial/chapter5.html ./javax/sql/rowset/package.html -m http://java.sun.com/doc/books/tutorial/uiswing/components/menu.html ./javax/swing/JMenu.java -m http://java.sun.com/doc/books/tutorial/uiswing/components/spinner.html ./javax/swing/JSpinner.java -m http://java.sun.com/docs/books/jdbc ./javax/sql/package.html ./java/sql/package.html -404 http://java.sun.com/docs/books/tutorial/javabeans/properties/bound.html ./javax/swing/JTable.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/componentlistener.html ./java/awt/event/ComponentListener.java ./java/awt/event/ComponentAdapter.java ./java/awt/event/ComponentEvent.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/containerlistener.html ./java/awt/event/ContainerAdapter.java ./java/awt/event/ContainerListener.java ./java/awt/event/ContainerEvent.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/eventmodel.html ./java/awt/event/ActionListener.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/focuslistener.html ./java/awt/event/FocusEvent.java ./java/awt/event/FocusListener.java ./java/awt/event/FocusAdapter.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/itemlistener.html ./java/awt/event/ItemEvent.java ./java/awt/event/ItemListener.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/keylistener.html ./java/awt/event/KeyListener.java ./java/awt/event/KeyAdapter.java ./java/awt/event/KeyEvent.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/mouselistener.html ./java/awt/event/MouseEvent.java ./java/awt/event/MouseListener.java ./java/awt/event/MouseAdapter.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/mousemotionlistener.html ./java/awt/event/MouseEvent.java ./java/awt/event/MouseMotionListener.java ./java/awt/event/MouseMotionAdapter.java -404 http://java.sun.com/docs/books/tutorial/post1.0/ui/windowlistener.html ./java/awt/event/WindowAdapter.java ./java/awt/event/WindowEvent.java ./java/awt/event/WindowFocusListener.java -404 http://java.sun.com/docs/books/tutorial/uiswing/misc/border.html ./javax/swing/border/Border.java ./javax/swing/border/package.html ./javax/swing/JComponent.java ./javax/swing/BorderFactory.java -404 http://java.sun.com/docs/books/tutorial/uiswing/misc/dnd.html ./java/awt/datatransfer/DataFlavor.java ./java/awt/datatransfer/Transferable.java ./javax/swing/JDialog.java ./javax/swing/TransferHandler.java ./javax/swing/JApplet.java ./javax/swing/JWindow.java ./javax/swing/JComponent.java ./javax/swing/JFrame.java -404 http://java.sun.com/docs/books/tutorial/uiswing/misc/icon.html ./javax/swing/ImageIcon.java -404 http://java.sun.com/docs/books/tutorial/uiswing/misc/plaf.html ./javax/swing/JComponent.java -404 http://java.sun.com/docs/books/tutorial/uiswing/misc/threads.html ./javax/swing/SwingWorker.java ./javax/swing/package.html -404 http://java.sun.com/docs/books/tutorial/uiswing/overview/anatomy.html ./javax/swing/BoundedRangeModel.java -404 http://java.sun.com/docs/books/tutorial/uiswing/overview/draw.html ./javax/swing/JComponent.java -404 http://java.sun.com/docs/books/tutorial/uiswing/overview/hierarchy.html ./javax/swing/JComponent.java -404 http://java.sun.com/docs/books/tutorial/uiswing/overview/threads.html ./javax/swing/text/html/parser/package.html ./javax/swing/text/rtf/package.html ./javax/swing/plaf/multi/package.html ./javax/swing/text/html/package.html ./javax/swing/filechooser/package.html ./javax/swing/colorchooser/package.html ./javax/swing/plaf/package.html ./javax/swing/plaf/metal/package.html ./javax/swing/table/package.html ./javax/swing/border/package.html ./javax/swing/plaf/basic/package.html ./javax/swing/event/package.html ./javax/swing/text/package.html ./javax/swing/undo/package.html ./javax/swing/tree/package.html -404 http://java.sun.com/j2se/1.3/docs/guide/2d/spec/j2d-intro.fm2.html#61857 ./java/awt/geom/Line2D.java -404 http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html ./com/sun/java/util/jar/pack/package.html -404 http://java.sun.com/j2se/1.4/docs/tooldocs/solaris/jdb.html ./com/sun/tools/example/doc/jdb.html -404 http://java.sun.com/j2se/1.4/docs/tooldocs/win32/jdb.html ./com/sun/tools/example/doc/jdb.html -m http://java.sun.com/j2se/corejava/intl/reference/faqs/index.html#desktop-rendering ./java/awt/Font.java -m http://java.sun.com/products/jaas ./com/sun/security/sasl/digest/DigestMD5Client.java -m http://java.sun.com/products/javabeans ./javax/sql/rowset/package.html -m http://java.sun.com/products/javabeans/docs/index.html ./java/beans/Introspector.java -m http://java.sun.com/products/jce ./com/sun/security/sasl/digest/DigestMD5Client.java -m http://java.sun.com/products/jdbc ./javax/sql/rowset/package.html -m http://java.sun.com/products/jfc/tsc ./javax/swing/plaf/basic/BasicComboBoxUI.java ./javax/swing/text/Document.java ./javax/swing/JList.java ./javax/swing/JComboBox.java -m http://java.sun.com/products/jfc/tsc/ ./javax/swing/plaf/multi/doc-files/multi_tsc.html -m http://java.sun.com/products/jfc/tsc/articles/architecture/#pluggable ./javax/swing/plaf/multi/doc-files/multi_tsc.html -m http://java.sun.com/products/jfc/tsc/articles/mixing/ ./javax/swing/JRootPane.java -m http://java.sun.com/products/jfc/tsc/articles/mixing/index.html ./javax/swing/JComboBox.java -m http://java.sun.com/products/jfc/tsc/articles/painting/index.html ./java/awt/Component.java -m http://java.sun.com/products/jfc/tsc/articles/persistence2/ ./java/beans/package.html -m http://java.sun.com/products/jfc/tsc/articles/persistence3 ./java/beans/XMLDecoder.java -m http://java.sun.com/products/jfc/tsc/articles/persistence3/ ./javax/swing/plaf/synth/doc-files/synthFileFormat.html ./java/beans/XMLDecoder.java -m http://java.sun.com/products/jfc/tsc/articles/persistence4 ./java/beans/XMLEncoder.java -m http://java.sun.com/products/jfc/tsc/articles/text/element_interface ./javax/swing/text/Document.java -m http://java.sun.com/products/jfc/tsc/articles/timer/ ./javax/swing/Timer.java -m http://java.sun.com/products/jfc/tsc/special_report/kestrel/keybindings.html ./javax/swing/plaf/basic/BasicComboBoxUI.java ./javax/swing/JComponent.java -m http://java.sun.com/products/jfc/tsc/tech_topics/jlist_1/jlist.html ./javax/swing/JList.java -m http://java.sun.com/products/jlf/ed2/book/HIG.Visual2.html ./javax/swing/plaf/metal/MetalLookAndFeel.java -m http://java.sun.com/products/jndi ./javax/sql/rowset/spi/package.html -m http://java.sun.com/products/jpda ./jdi-overview.html -m http://java.sun.com/tutorial/jdbc ./javax/sql/rowset/spi/package.html
24-04-2014

Duplicate :	JDK-8015337 - Invalid link to the Swing Connection on javax.swing.Timer javadoc
Relates :	JDK-8020688 - broken links in documentation at http://docs.oracle.com/javase/6/docs/api/index.