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

*** 191,201 ****
   * element-based versions of the {@code equals} and {@code hashCode}
   * methods, but instead inherit the identity-based versions from class
   * {@code Object}.
   *
   * <p>This interface is a member of the
!  * <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework">
   * Java Collections Framework</a>.
   *
   * @author Doug Lea
   * @author Josh Bloch
   * @since  1.6
--- 191,201 ----
   * element-based versions of the {@code equals} and {@code hashCode}
   * methods, but instead inherit the identity-based versions from class
   * {@code Object}.
   *
   * <p>This interface is a member of the
!  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
   * Java Collections Framework</a>.
   *
   * @author Doug Lea
   * @author Josh Bloch
   * @since  1.6
*** 361,374 ****
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean removeFirstOccurrence(Object o);
  
      /**
       * Removes the last occurrence of the specified element from this deque.
--- 361,374 ----
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean removeFirstOccurrence(Object o);
  
      /**
       * Removes the last occurrence of the specified element from this deque.
*** 380,393 ****
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean removeLastOccurrence(Object o);
  
      // *** Queue methods ***
  
--- 380,393 ----
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean removeLastOccurrence(Object o);
  
      // *** Queue methods ***
  
*** 563,576 ****
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean remove(Object o);
  
      /**
       * Returns {@code true} if this deque contains the specified element.
--- 563,576 ----
       *
       * @param o element to be removed from this deque, if present
       * @return {@code true} if an element was removed as a result of this call
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean remove(Object o);
  
      /**
       * Returns {@code true} if this deque contains the specified element.
*** 579,592 ****
       *
       * @param o element whose presence in this deque is to be tested
       * @return {@code true} if this deque contains the specified element
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean contains(Object o);
  
      /**
       * Returns the number of elements in this deque.
--- 579,592 ----
       *
       * @param o element whose presence in this deque is to be tested
       * @return {@code true} if this deque contains the specified element
       * @throws ClassCastException if the class of the specified element
       *         is incompatible with this deque
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       * @throws NullPointerException if the specified element is null and this
       *         deque does not permit null elements
!      * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
       */
      boolean contains(Object o);
  
      /**
       * Returns the number of elements in this deque.