JDK-6318130 : (thread spec) Generalize JLS 8 section 17.3 to javadoc of methods related to Thread.sleep()
  • Type: Enhancement
  • Component: core-libs
  • Sub-Component: java.lang
  • Affected Version: 6
  • Priority: P3
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2005-08-31
  • Updated: 2017-05-19
Related Reports
Relates :  
JDK-6317167 - (thread spec) Make Thread.sleep javadoc fully in line with JLS 17.9
Description
There is commonality between Thread.sleep and other methods like Object.wait such that the javadoc of the related methods would benefit from at least some of the Thread.sleep specification text in JLS version 3.0 section 17.9.  In particular users with idealistic expectations of Thread.sleep might have similar expectations about Object.wait(long) and Thread.join(long).
Comments
This section is now apparently 17.3 of JLS 8.
18-02-2015
EVALUATION This is just intended to extend documented constraints of Thread.sleep wrt to the JLS 17 wording about precision to the few other APIs that are subject to similar constraints: at a minimum Object.wait(long) and Thread.join(long).
07-05-2006