RFR: 8297605: DelayQueue javadoc is confusing

[Viktor Klang]

The message from this sender included one or more files
which could not be scanned for virus detection; do not
open these files unless you are certain of the sender's intent.

----------------------------------------------------------------------
On Thu, 2 Mar 2023 20:00:56 GMT, Martin Buchholz <martin at openjdk.org> wrote:

> Inviting @DougLea and @viktorklang-ora to review.
> 
> As usual, I couldn't resist more fiddling.  
> - Added missing tests for take, remove(), remove(Object).
> - Improved DelayQueueTest's testing infrastructure
> - added more test assertions
> - linkified new javadoc definitions

@Martin-Buchholz I think the updated documentation is clearer. We need some extra reviewers like @AlanBateman or @pron to sign off :)

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

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