RFR: JDK-8133773: clarify specification of Spliterator.tryAdvance

[Paul Sandoz]

On Mon, 8 May 2023 10:32:48 GMT, Viktor Klang <duke at openjdk.org> wrote:

> Attempting to make the "at-most once" nature, of invoking the supplied action to tryAdvance, clearer in the JavaDoc.

src/java.base/share/classes/java/util/Spliterator.java line 307:

> 305:      * an exception.
> 306:      *
> 307:      * @param action The action which will be invoked at-most once

If you want to align with the language specified in `Consumer` i recommend:
Suggestion:

     * @param action The action whose operation is performed at-most once

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

PR Review Comment: https://git.openjdk.org/jdk/pull/13860#discussion_r1187767008