RFR: 8308694: Clarify reversed() default methods' implementation requirements

[Roger Riggs]

On Thu, 15 Jun 2023 22:38:43 GMT, Stuart Marks <smarks at openjdk.org> wrote:

> Can I get a preliminary review of the wording for Deque.reversed()? If the text is good, I'll make corresponding changes to the implSpecs of the other reversed() default methods, namely those in List, SortedMap, and SortedSet and then file the CSR.

src/java.base/share/classes/java/util/Deque.java line 626:

> 624:      * inverse-ordered method of this Deque. For example, the {@code getFirst}
> 625:      * method of the returned view delegates to the {@code getLast} method of
> 626:      * this Deque.

The description is general and using 'For example" avoids having to be specific about every operation.
The term "inverse-ordered" is new to this context and perhaps should be "reverse-ordered".
"inverse" does appear in a few other class descriptions for SequencedXXX but its relation to "reverse" may not be clear.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14504#discussion_r1232405338