United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 4783335 Javadoc for method java.beans.Introspector.getBeanInfoSearchPath not complete
4783335 : Javadoc for method java.beans.Introspector.getBeanInfoSearchPath not complete

Details
Type:
Bug
Submit Date:
2002-11-22
Status:
Resolved
Updated Date:
2004-09-24
Project Name:
JDK
Resolved Date:
2004-09-24
Component:
docs
OS:
solaris_8
Sub-Component:
guides
CPU:
sparc
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0

Related Reports

Sub Tasks

Description
Name: dsR10051			Date: 11/22/2002


Javadoc for method of class java.beans.Introspector

public static synchronized String[] getBeanInfoSearchPath()

says nothing about default value of search path.
Specification for this initial value has been removed from javadoc 
due to bug fix #4234304 as implementation specific information.
This implementation specific information should be included to 
documentation. So, javadoc for this method should contain assertion likes follow:
"Default value for this array is implementation dependent, 
e.g. SUN implementation initialy sets it to {"sun.beans.infos"}." 

======================================================================

Comments
EVALUATION

> In my mind, the "bad form" aspect is that once you mention it
> for one platform, you are "favoring" that platform over others
> (and the list can never be complete or guaranteed accurate).
> But including an example seems fine to me.
> I see no problem with the wording suggested in the second bug
> report:
> 
>  "Default value for this array is implementation dependent,
>   e.g. SUN implementation initialy sets it to {"sun.beans.infos"}."
> 
> This would seem to satisfy both bug requests.  Would this be
> acceptable?

This is fine with me.

###@###.###

Fixed as mentioned above.

###@###.### 2003-09-05
2004-09-25 
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
generic
tiger-beta

FIXED IN:
tiger
tiger-beta

INTEGRATED IN:
tiger-b28
tiger-beta

VERIFIED IN:
1.5.0_01
2004-09-25


Hardware and Software, Engineered to Work Together