RFR: JDK-8297605 DelayQueue javadoc is confusing [v2]

[Viktor Klang]

On Fri, 24 Feb 2023 16:08:57 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.
>
> Viktor Klang has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains one commit:
> 
>   JDK-8297605 DelayQueue javadoc is confusing

Perhaps @pavelrappo has any suggestion for adding clarifying Javadoc to a subclass without having to override the method? 🤔

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

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