RFR(s) #2: 6344935: (spec) clarify specifications for Object.wait overloads
stuart.marks at oracle.com
Fri Aug 18 19:59:25 UTC 2017
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