I think the following proposal is very non-invasive and merely draws attention to the fact that "witness value" is a specific term related to the notion of these atomic methods.
It's a small change which I think provides additional clarity, see JBS for the discussion on the topic. ------------- Commit messages: - JDK-8302360 : Adding emphasis to the witness value term in the JavaDoc Changes: https://git.openjdk.org/jdk/pull/12880/files Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=12880&range=00 Issue: https://bugs.openjdk.org/browse/JDK-8302360 Stats: 34 lines in 8 files changed: 0 ins; 0 del; 34 mod Patch: https://git.openjdk.org/jdk/pull/12880.diff Fetch: git fetch https://git.openjdk.org/jdk pull/12880/head:pull/12880 PR: https://git.openjdk.org/jdk/pull/12880
