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

[Martin Buchholz]

Future projects:

 377      * <li>The specified amount of real time has elapsed, more or less.

Replace with

* <li>At least the specified amount of real time has elapsed.

(I think I failed to persuade David last time ...)

---

We should add a @see to TimeUnit.timedWait which at least deals with
excessNanos.

---
What percentage of the jdk's wait loops are actually correct?
Especially if you throw in the requirement to only call System.nanoTime
after checking the condition the first time.
Wait loops should probably not call currentTimeMillis.
Writing a good timed wait loop is surprisingly tricky.
Condition.awaitNanos helps by returning the updated time to wait.  See our
competing code snippet:
http://download.java.net/java/jdk9/docs/api/java/util/concurrent/locks/Condition.html#awaitNanos-long-

Maybe the code snippet should use the plain millis form, since the excess
nanos are pretty much useless this decade.