RFR: 8319123: Implement JEP 461: Stream Gatherers (Preview) [v13]

[Viktor Klang]

On Tue, 21 Nov 2023 10:11:28 GMT, Viktor Klang <vklang at openjdk.org> wrote:

>> This Pull-Request implements [JEP-461](https://openjdk.org/jeps/461)
>
> Viktor Klang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Javadoc clarifications for Gatherer type parameters,
>   correcting descriptions of Integrator type parameters,
>   and more consistently use "initializer function" instead
>   of "supplier function".

src/java.base/share/classes/java/util/stream/Gatherer.java line 314:

> 312:      * @see Gatherer#finisher()
> 313:      * @return the instance of the default finisher
> 314:      * @param <A> the type of the state of the returned finisher

@AlanBateman @PaulSandoz Making the following changes following conversation on core-libs ML, plus I noted that some of the descriptions of the Integrator type parameters were mis-targeted.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/16420#discussion_r1400345490