RFR: 8373243 : EnumSet.spliterator() should specify and document its characteristics [v3]

[Viktor Klang]

> Addresses https://bugs.openjdk.org/browse/JDK-8373243 by copying and adapting the specification from https://github.com/openjdk/jdk/blob/master/src/java.base/share/classes/java/util/LinkedHashSet.java#L186-L204
> 
> Since EnumSet is sealed and only permits two final classes, the verbiage around "Implementations should document the reporting of additional characteristic values." may be considered to get removed from this PR. Kept, for now, for symmetry reasons.

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

  Documenting that the EnumSet::spliterator() is non-fail-fast, and change implNote to implSpec

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/28696/files
  - new: https://git.openjdk.org/jdk/pull/28696/files/780252ca..6a588fcd

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

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

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