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.