RFR: 8359919: Minor java.util.concurrent doc improvements

[Chen Liang]

On Wed, 18 Jun 2025 17:51:20 GMT, Doug Lea <dl at openjdk.org> wrote:

> This collects miscellaneous open issues that can be resolved with documentation updates; each indicated by adding JDK issue numbers

I think the problem in `AtomicReferenceFieldUpdater` being passed a static field exists for the other kinds of field updaters too. Currently the IAE is thrown by Unsafe, which is a hidden contract and can be inadvertently changed and affect the APIs; we might consider throwing IAE for static fields explicitly instead to avoid this pitfall.

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

PR Comment: https://git.openjdk.org/jdk/pull/25880#issuecomment-2985285177