United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-4849366 : API doc for MenuSelectionManager.setSelectedPath() isn't clear

Details
Type:
Bug
Submit Date:
2003-04-16
Status:
Closed
Updated Date:
2004-09-01
Project Name:
JDK
Resolved Date:
2003-11-27
Component:
docs
OS:
solaris_2.6
Sub-Component:
guides
CPU:
sparc
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0 (b30)

Related Reports

Sub Tasks

Description
Name: apR10229			Date: 04/16/2003



Specification of the
javax.swing.MenuSelectionManager.setSelectedPath(MenuElement[] path)
method is not clear. It does not specify the path to be processed.
We can not write adequate tests for this method according to the existing
documentation, because parameter path is described as
"an array of MenuElement objects specifying the selected path". It does
not specify the element hierarchy to be proceeded. E.g. it is unclear with
what element path hierarhy should start and should it be either absolute,
or relative?

So, the existing specification of the method setSelectedPath()
does not contradict with testcases, described as "incorrect" in bug report
#4842133. From point of view of the current API documentation, these
testcases cannot be treated as "invalid". Thus, we got NPE as a result
of writing tests by unclear specification.

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

                                    

Comments
EVALUATION

Name: dk30142			Date: 04/18/2003

Accepted

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

Change reviewed by Scott.  Approved by CCC.  Fixed for tiger.
###@###.### 2003-11-17
                                     
2003-11-17
PUBLIC COMMENTS

.
                                     
2004-09-13
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
generic
tiger-beta

FIXED IN:
tiger-beta

INTEGRATED IN:
tiger-b30
tiger-beta

VERIFIED IN:
tiger-rc


                                     
2004-09-13



Hardware and Software, Engineered to Work Together