JDK-6455248 : JVMTI Doc: MonitorWait / MonitorWaited event description misleading
  • Type: Bug
  • Component: hotspot
  • Sub-Component: jvmti
  • Affected Version: 5.0
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2006-07-31
  • Updated: 2011-02-16
  • Resolved: 2006-08-10
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.
JDK 6
6 b95Fixed
Related Reports
Relates :  
Relates :  
Description
The description of the MonitorWait event is:

  Sent when a thread is about to wait on an object. 
  That is, a thread is entering Object.wait().

The second sentence is confusing because it is unclear if the thread has actually entered Object.wait() and more confusingly which of the "wait" methods on Object.  Note that one wait method may call another.
Note that the MonitorWaited event description has a second sentence that is confusing in the same way.

Comments
EVALUATION Should be fixed. See Suggested Fix. In a future release the spec should be appropriately clarified.
31-07-2006

SUGGESTED FIX Remove the confusing second sentence.
31-07-2006