RFR: JDK-8297605 DelayQueue javadoc is confusing

[Doug Lea]

On Thu, 23 Feb 2023 15:36:48 GMT, Viktor Klang <duke at openjdk.org> wrote:

> Clarifies the distinction between expiration of the head of DelayQueue and how it relates to `poll`, `take`, and `peek`. See discussion on https://bugs.openjdk.org/browse/JDK-8297605
> 
> @DougLea If possible, please weigh in on whether this is in line with your thoughts on the matter.

Thanks. Adding the word "expired" (plus other adjustments) seems to be the simplest way to avoid confusion.

-------------

PR: https://git.openjdk.org/jdk/pull/12729