--- 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