RFR(s) #2: 6344935: (spec) clarify specifications for Object.wait overloads

Stuart Marks stuart.marks at oracle.com
Fri Aug 18 19:59:25 UTC 2017

Hi all,

Well nothing is ever simple, is it? Prompted by David Holmes' comments, I looked 
at the other overloads of wait(), and I agree that they're in need of cleanup. I 
decided to put the most complete version of the specification into the 
wait(timeout, nanos) overload, and then I simply redefined the other overloads 
wait(timeout) and wait() in terms of the first. This avoids redundancies that 
creep in when what ought to be the same specification is replicated across 
different overloads (which is probably how the specs for these methods diverged 
in the first place).

I've incorporated comments from Martin Buchholz and Hans Boehm. I've done a 
little bit of rewriting where I thought it was necessary, particularly in the 
lead sentences of the specs. Plus I added a few editorial cleanups.

Since this has gotten bigger, here's a webrev:


Please review. Thanks.


More information about the core-libs-dev mailing list