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

[Pavel Rappo]

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

src/java.base/share/classes/java/util/concurrent/Flow.java line 64:

> 62:  * control required in most implementations (for example {@link
> 63:  * SubmissionPublisher}), and omits some error processing needed to
> 64:  * fully conform to ReactiveStream rules.

I had to re-read the comments on the relevant [issue] from 2018; thanks for fixing it.

Nit: ReactiveStream. Earlier in that doc comment, it is referred to as "reactive-streams". We should choose one of those.

We can say reactive-streams or Reactive Streams. The latter seems to be the term of choice at https://github.com/reactive-streams/reactive-streams-jvm/.

@viktorklang-ora, thoughts?

[issue]: https://bugs.openjdk.org/browse/JDK-8210149

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

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