JDK-4521661 : REGRESSION: stddoclet: serialized form links no longer contain anchors to class
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: solaris_8
  • CPU: sparc
  • Submitted: 2001-10-31
  • Updated: 2014-05-05
  • Resolved: 2002-10-25
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.
Other
1.4.2 mantisFixed
Description
In Merlin Beta 3, the "Serialized Form" links in the class documentation pages no longer reference anchors to bring the browser to the appropriate class within the larger serialized form page.  This is generally inconvenient, and particularly inconvenient with the J2SE serialized form page because it is so massive that it is quite cumbersome to find the desired class manually.

In previous versions (including Merlin Beta 2), the "Serialized Form" links would take the browser to the appropriate anchor within the larger serialized form page for the current class.

As an example, consider the J2SE documentation itself-- compare equivalent cases from the following public documentation sets:

	http://java.sun.com/j2se/1.3/docs/api/
	http://java.sun.com/j2se/1.4/docs/api/

Choose the class java.rmi.MarshalledObject and click on the "Serialized Form" link from each one.  In the 1.3 documentation set, the current frame goes to the combined serialized form page correctly positioned at the serialized form for the MarshalledObject class, presumably because the "Serialized Form" link references the appropriate anchor; from the HTML source of the 1.3 page:

<A HREF="../../serialized-form.html#java.rmi.MarshalledObject">Serialized Form</A>

In the 1.4 documentation set, the combined serialized form page is brought up in a new window with the browser at the top of the document; compare the HTML source of the 1.4 page:

<A HREF="../../serialized-form.html" TARGET="java.rmi.MarshalledObject">Serialized Form</A>

The anchor is gone from the relative URL of the HREF attribute, and there is a TARGET attribute identifying the desired class instead.  I don't think that this is a correct used of the TARGET attribute (at least it doesn't seem to have the desired effect on Netscape 4.76 and IE 4.x), and I think that it's also what's created the serialized form page to be brought up in a new window.

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b05
2004-06-14

PUBLIC COMMENTS The link to the serialized form has been fixed. The proper anchor is now inserted into the link.
2004-06-10

EVALUATION The new implementation of omitting the named anchor (#) from the URL is definitely a mistake, as is the inclusion of the TARGET parameter. Both should be reverted to the 1.3 implementation. I'm not sure what motivated this change. ###@###.### 2001-11-01 I have fixed this bug. The bug fix is pending review. ###@###.### 2002-07-08
2001-11-01