RFR: JDK-8151531: Add notes to BaseStream.spliterator/iterator docs regarding them being escape hatches [v2]

Tue May 9 16:27:27 UTC 2023

On Tue, 9 May 2023 16:06:12 GMT, Paul Sandoz <psandoz at openjdk.org> wrote:

>> Viktor Klang has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Using apiNote and rewording from method to operation
>
> I would recommend:
> - using `@apiNote` (might have to be placed at the end of the documentation); and 
> - say "This operation is provided ..."

@PaulSandoz Makes a lot of sense. Done.

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

PR Comment: https://git.openjdk.org/jdk/pull/13890#issuecomment-1540490208