JDK-6198765 : spurious anonymous classes on Serialized Form page
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 5.0
  • Priority: P4
  • Status: Closed
  • Resolution: Cannot Reproduce
  • OS: generic
  • CPU: generic
  • Submitted: 2004-11-22
  • Updated: 2024-10-07
  • Resolved: 2018-02-13
Related Reports
Relates :  
Relates :  
Description
The Serialized Form page for Tiger contains mention of a bunch of anonymous classes that don't belong there.  For example, go to this anchor on the page:

http://webmirror.sfbay/j2se/1.5.0/docs/api/serialized-form.html#java.util.ArrayList

and page up, and there are these anonymous classes:

- Class java.util.AbstractMap$1 extends Object implements Serializable
- Class java.util.AbstractMap$1$1 extends Object implements Serializable
- Class java.util.AbstractMap$2 extends Object implements Serializable
- Class java.util.AbstractMap$2$1 extends Object implements Serializable

These classes are non-public, do not have "@serial include" (how could they?), and they don't even implement Serializable.  (And FWIW, AbstractMap$1 actually extends AbstractSet, and AbstractMap$2 actually extends AbstractCollection.)

There is a similar batch under java.util.Collections, after its correctly @serial-included nested member classes, and a few more under SubList, TreeMap, and Vector; for whatever reason, there do not appear to be any examples that are unrelated to collections classes.

Compare with the 1.4.2 page:

http://webmirror.sfbay/j2se/1.4.2/docs/api/serialized-form.html#java.util.ArrayList

This bug appears closely related to 4923163, which was marked fixed in Tiger Beta, but seems to have been re-exposed for Beta2 when 4982231 was integrated.

Comments
The spurious anonymous classes were removed from the Serialized Form page of the Java SE 6 specification.
15-02-2018

The issue as reported does not seem to be present in the current docs for JDK 9. Closing as Not Reproducible.
13-02-2018

EVALUATION ###@###.### wrote: Probably best made a tool bug, though the original workaround was in the doclet. Reassigning to javadoctool subcategory. ###@###.### 2005-07-19 01:22:56 GMT
19-07-2005