United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4874845 : Non public superclass mentioned in inherited javadoc

Details
Type:
Bug
Submit Date:
2003-06-05
Status:
Resolved
Updated Date:
2003-11-23
Project Name:
JDK
Resolved Date:
2003-11-23
Component:
docs
OS:
solaris_7
Sub-Component:
doclet
CPU:
sparc
Priority:
P3
Resolution:
Fixed
Affected Versions:
5.0
Fixed Versions:
5.0 (b30)

Related Reports
Relates:

Sub Tasks

Description
I have a non public superclass which provides shared javadoc for two subclasses. The javadoc produced says "Description copied from class:..." but it should not do that when the superclass is not public. 

It also shows the non-public superclass in the hierarchy at the top of the page for the class.

                                    

Comments
EVALUATION

Name: dk30142			Date: 06/05/2003
Accepted

This bug is related to 4780441:
 Incorrectly documents inherited members from package-private class

###@###.### 2003-10-29


This current bug report essentially asks to undo the fix for 4780441.
Please see that other report for the reasons that it's doing what it's
doing.

Documenting a method as being declared in one class when it's really
declared in another class potentially creates spec conformance problems.
It's possible to tell at runtime which methods are directly declared
by a class, and our implementation would no longer conform to the spec.

###@###.### 2003-11-05

Re-committing to tiger-beta
###@###.### 2003-11-05

Fixed.  Non-public superclasses are no longer mentioned in the javadoc at all.  	It is now documented that StringBuilder extends Object.  The members inherited from AbstractStringBuilder are documented in StringBuilder as though they were declared in StringBuilder.  There is absolutely no mention of AbstractStringBuilder in the documentation.
###@###.### 2003-11-15
                                     
2003-11-15
PUBLIC COMMENTS

-
                                     
2004-06-10
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b30
tiger-beta


                                     
2004-06-14



Hardware and Software, Engineered to Work Together