8314896: additional clarifications to reversed() default methods' implementation requirements

Reviewed-by: bchristi

Author: Stuart Marks

src/java.base/share/classes/java/util/Deque.java

@@ -622,9 +622,9 @@ public interface Deque<E> extends Queue<E>, SequencedCollection<E> {
      * to this Deque. Other operations on the view are implemented via calls to
      * public methods on this Deque. The exact relationship between calls on the
      * view and calls on this Deque is unspecified. However, order-sensitive
-     * operations generally delegate to the appropriate method with the opposite
-     * orientation. For example, calling {@code getFirst} on the view results in
-     * a call to {@code getLast} on this Deque.
+     * operations generally behave as if they delegate to the appropriate method
+     * with the opposite orientation. For example, calling {@code getFirst} on
+     * the view might result in a call to {@code getLast} on this Deque.
      *
      * @return a reverse-ordered view of this collection, as a {@code Deque}
      * @since 21

src/java.base/share/classes/java/util/List.java

@@ -891,9 +891,9 @@ default E removeLast() {
      * to this List. Other operations on the view are implemented via calls to
      * public methods on this List. The exact relationship between calls on the
      * view and calls on this List is unspecified. However, order-sensitive
-     * operations generally delegate to the appropriate method with the opposite
-     * orientation. For example, calling {@code getFirst} on the view results in
-     * a call to {@code getLast} on this List.
+     * operations generally behave as if they delegate to the appropriate method
+     * with the opposite orientation. For example, calling {@code getFirst} on
+     * the view might result in a call to {@code getLast} on this List.
      *
      * @return a reverse-ordered view of this collection, as a {@code List}
      * @since 21

src/java.base/share/classes/java/util/SortedMap.java

@@ -321,9 +321,9 @@ default V putLast(K k, V v) {
      * to this SortedMap. Other operations on the view are implemented via calls to
      * public methods on this SortedMap. The exact relationship between calls on the
      * view and calls on this SortedMap is unspecified. However, order-sensitive
-     * operations generally delegate to the appropriate method with the opposite
-     * orientation. For example, calling {@code firstEntry} on the view results in
-     * a call to {@code lastEntry} on this SortedMap.
+     * operations generally behave as if they delegate to the appropriate method
+     * with the opposite orientation. For example, calling {@code firstEntry} on
+     * the view might result in a call to {@code lastEntry} on this SortedMap.
      *
      * @return a reverse-ordered view of this map, as a {@code SortedMap}
      * @since 21

src/java.base/share/classes/java/util/SortedSet.java

@@ -365,9 +365,9 @@ default E removeLast() {
      * to this SortedSet. Other operations on the view are implemented via calls to
      * public methods on this SortedSet. The exact relationship between calls on the
      * view and calls on this SortedSet is unspecified. However, order-sensitive
-     * operations generally delegate to the appropriate method with the opposite
-     * orientation. For example, calling {@code getFirst} on the view results in
-     * a call to {@code getLast} on this SortedSet.
+     * operations generally behave as if they delegate to the appropriate method
+     * with the opposite orientation. For example, calling {@code getFirst} on the
+     * view might result in a call to {@code getLast} on this SortedSet.
      *
      * @return a reverse-ordered view of this collection, as a {@code SortedSet}
      * @since 21