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: 4874845
Votes 0
Synopsis Non public superclass mentioned in inherited javadoc
Category doclet:tbd
Reported Against tiger
Release Fixed 1.5(tiger-b30)
State 10-Fix Delivered, bug
Priority: 3-Medium
Related Bugs 4780441
Submit Date 05-JUN-2003
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.
Work Around
N/A
Evaluation
Accepted

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

 xxxxx@xxxxx  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.

 xxxxx@xxxxx  2003-11-05

Re-committing to tiger-beta
 xxxxx@xxxxx  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.
 xxxxx@xxxxx  2003-11-15
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang