JDK-6317167 : (thread spec) Make Thread.sleep javadoc fully in line with JLS 17.9
  • Type: Bug
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 6
  • Priority: P4
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2005-08-29
  • Updated: 2018-09-11
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
tbdUnresolved
Related Reports
Relates :  
Relates :  
Relates :  
Relates :  
Description
Bug 6312446 had a thoughtlessly worded synopsis because the bug description served as a qualification that only a specific (uncontroversial) clause of 17.9 would go into the Thread.sleep javadoc as a clarification (see the "original problem description" of 5068368). 

This change request finishes the job of putting all of the rest of the 17.9 spec related to Thread.sleep into the sleep  methodjavadoc, subject to condensing for the sake of javadoc brevity. Specifically the 17.9 text would be changed in the following two ways before inclusion in the javadoc:

  1) The text "nor a yield operation" will be omitted, as this is a spec for a different method, not sleep.
  2) The text starting with "It is important to note" will be summarized for the javadoc by the statement "Thread.sleep does not have any synchronization semantics."

Comments
It appears that the JLS section in question, on sleep and yield, is now section 17.3: http://docs.oracle.com/javase/specs/jls/se8/html/jls-17.html#jls-17.3
18-02-2015

EVALUATION Changes covered in description will be implemented.
08-09-2005