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

[Martin Buchholz]

Good work!

On Fri, Aug 18, 2017 at 12:59 PM, Stuart Marks <stuart.marks at oracle.com>
wrote:

>
> Well nothing is ever simple, is it?


Especially not when you're modifying Object, and have the pickiest
reviewers on the planet!

 More picky comments you are free to ignore:

432      * @param  timeout the maximum time to wait in milliseconds

Can we add a comma after wait?

---

 440      * @see    #notify() 441      * @see    #notifyAll()

You already have @link's to these methods in this javadoc, so delete these.
More generally, I would try to remove most @see's with inline @link's as is
done elsewhere.