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

rev 54827 : 6394757: AbstractSet.removeAll semantics are surprisingly dependent on relative sizes
Reviewed-by: XXX

*** 1,7 ****
  /*
!  * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
--- 1,7 ----
  /*
!  * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
*** 510,527 ****
                                                 ") > toIndex(" + toIndex + ")");
      }
  
      // Comparison and hashing
  
      /**
       * Compares the specified object with this list for equality.  Returns
       * {@code true} if and only if the specified object is also a list, both
       * lists have the same size, and all corresponding pairs of elements in
       * the two lists are <i>equal</i>.  (Two elements {@code e1} and
       * {@code e2} are <i>equal</i> if {@code (e1==null ? e2==null :
       * e1.equals(e2))}.)  In other words, two lists are defined to be
!      * equal if they contain the same elements in the same order.
       *
       * @implSpec
       * This implementation first checks if the specified object is this
       * list. If so, it returns {@code true}; if not, it checks if the
       * specified object is a list. If not, it returns {@code false}; if so,
--- 510,531 ----
                                                 ") > toIndex(" + toIndex + ")");
      }
  
      // Comparison and hashing
  
+     // FIXME: the first paragraph below is copied from Set.equals, because
+     // {@inheritDoc} inherits text from superclasses, not interfaces (see JDK-6376959).
      /**
       * Compares the specified object with this list for equality.  Returns
       * {@code true} if and only if the specified object is also a list, both
       * lists have the same size, and all corresponding pairs of elements in
       * the two lists are <i>equal</i>.  (Two elements {@code e1} and
       * {@code e2} are <i>equal</i> if {@code (e1==null ? e2==null :
       * e1.equals(e2))}.)  In other words, two lists are defined to be
!      * equal if they contain the same elements in the same order.  This
!      * definition ensures that the {@code equals} method works properly across
!      * different implementations of the {@code List} interface.
       *
       * @implSpec
       * This implementation first checks if the specified object is this
       * list. If so, it returns {@code true}; if not, it checks if the
       * specified object is a list. If not, it returns {@code false}; if so,