JDK-4849366 : API doc for MenuSelectionManager.setSelectedPath() isn't clear
  • Type: Bug
  • Component: docs
  • Sub-Component: guides
  • Affected Version: 1.4.2
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: solaris_2.6
  • CPU: sparc
  • Submitted: 2003-04-16
  • Updated: 2017-05-16
  • Resolved: 2003-11-27
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
Other
5.0 b30Fixed
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
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
13-09-2004
PUBLIC COMMENTS .
13-09-2004
EVALUATION Name: dk30142 Date: 04/18/2003 Accepted ====================================================================== Change reviewed by Scott. Approved by CCC. Fixed for tiger. ###@###.### 2003-11-17
17-11-2003