Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 6182000
Votes 0
Synopsis StringBuilder javadoc doesn't match source code.
Category java:classes_lang
Reported Against
Release Fixed
State 11-Closed, Not a Defect, bug
Priority: 3-Medium
Related Bugs 4780441 , 5023741
Submit Date 20-OCT-2004
Description
FULL PRODUCT VERSION :
java version "1.5.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0-b64)
Java HotSpot(TM) Client VM (build 1.5.0-b64, mixed mode, sharing)

A DESCRIPTION OF THE PROBLEM :
The javadoc for java.lang.StringBuilder says that StringBuilder extends Object.  The source code shows that StringBuilder extends AbstractStringBuilder.  No javadoc exists for AbstractStringBuilder.


STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Look at javadoc.  Look at source.
http://java.sun.com/j2se/1.5.0/docs/api/java/lang/StringBuilder.html

REPRODUCIBILITY :
This bug can be reproduced always.
  xxxxx@xxxxx   10/20/04 18:26 GMT
Work Around
N/A
Evaluation
That StringBuilder extends AbstractStringBuilder is an
implementation detail of StringBuilder, not a part of its
exported API.  The format in which the Standard Doclet
presents inheritence information ("extends Object") is
certainly a bit misleading:  you should read that as
stating only that Object is extended, but not necessarily
directly.

A further discussion of this issue can be found in the javadoc
bug report 4780441.
  xxxxx@xxxxx   10/20/04 22:39 GMT
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang