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

[Pavel Rappo]

On Fri, 20 Jun 2025 15:54:49 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:
> 
>   Fix ARFU type; add JDK-7176957

src/java.base/share/classes/java/util/concurrent/CompletionStage.java line 153:

> 151:  * <p>Memory consistency effects: Actions in a thread prior to the
> 152:  * submission of a computation producing a {@code CompletionStage}
> 153:  * <i>happen-before</i> that computation begins. And actions taken by

Considering that it's the only occurrence of _happen(s)-before_ in this file, it makes sense to link it to its definition similarly to how it is done in other places.

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

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