RFR: 8359919: Minor java.util.concurrent doc improvements [v8]

[Alan Bateman]

On Thu, 19 Jun 2025 22:49:17 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
>
> Doug Lea has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Adding JDK-8333172 to doc improvements

src/java.base/share/classes/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.java line 86:

> 84:  *   }
> 85:  *   // ... and so on
> 86:  * }}</pre>

I wonder if this should be convert to a `{@snippet ..}` and have it handle the checked exceptions thrown by findVarHandle. I'm just thinking of someone seeing VarHandle usage for first time, then reporting a bug that the example doesn't compile.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/25880#discussion_r2158832831