--- old/src/java.base/share/classes/java/util/AbstractList.java 2019-05-13 17:16:08.000000000 -0700 +++ new/src/java.base/share/classes/java/util/AbstractList.java 2019-05-13 17:16:07.000000000 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. + * 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 @@ -512,6 +512,8 @@ // 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 @@ -519,7 +521,9 @@ * the two lists are equal. (Two elements {@code e1} and * {@code e2} are equal 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. + * 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