RFR: JDK-8297605 DelayQueue javadoc is confusing

Thu Feb 23 15:45:08 UTC 2023

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.

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

Commit messages:
 - JDK-8297605 DelayQueue javadoc is confusing

Changes: https://git.openjdk.org/jdk/pull/12729/files
 Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=12729&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8297605
  Stats: 14 lines in 1 file changed: 1 ins; 1 del; 12 mod
  Patch: https://git.openjdk.org/jdk/pull/12729.diff
  Fetch: git fetch https://git.openjdk.org/jdk pull/12729/head:pull/12729

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