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

[Viktor Klang]

> Still relevant to address? /cc @PaulSandoz

Viktor Klang has updated the pull request incrementally with one additional commit since the last revision:

  Using apiNote and rewording from method to operation

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/13890/files
  - new: https://git.openjdk.org/jdk/pull/13890/files/5082a0f5..4739a781

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=13890&range=01
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=13890&range=00-01

  Stats: 4 lines in 1 file changed: 0 ins; 0 del; 4 mod
  Patch: https://git.openjdk.org/jdk/pull/13890.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/13890/head:pull/13890

PR: https://git.openjdk.org/jdk/pull/13890