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

[Doug Lea]

On Thu, 19 Jun 2025 09:42:01 GMT, Viktor Klang <vklang at openjdk.org> wrote:

>> Doug Lea has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Address review comments
>
> src/java.base/share/classes/java/util/concurrent/CompletionStage.java line 155:
> 
>> 153:  * <i>happen-before</I> that computation begins. And actions taken by
>> 154:  * a {@code CompletionStage} <i>happen-before</i> actions of any
>> 155:  * dependent stage subsequent to its completion.
> 
> I found "its" ambiguous in that sentence, does it mean:
> 
> Suggestion:
> 
>  * dependent stage subsequent to that stage's completion.
> 
> 
> 🤔

Changed to:
 And actions taken by
 * {@code CompletionStage x} <i>happen-before</i> actions of any
 * dependent stage subsequent to {@code x}'s completion.

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

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