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

[Pavel Rappo]

On Fri, 20 Jun 2025 13:50:08 GMT, Doug Lea <dl at openjdk.org> wrote:

>> 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.
>
> I made it compilable, in the lest ugly way I could think of. Not sure if either or both should now be snippets? @pavelrappo any thoughts?

Up to you. Currently, in addition to what `<pre>{@code ...}</pre>` does, a snippet provides a copy-paste facility. Other than that, there isn't much it would buy you here.

In JDK 25 even pre-code is highlighted [^1]: https://cr.openjdk.org/~hannesw/8348282/api.00/java.base/java/util/concurrent/atomic/AtomicReferenceFieldUpdater.html

[^1]: https://mail.openjdk.org/pipermail/javadoc-dev/2025-April/008809.html

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

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