--- old/src/java.base/share/classes/java/util/List.java	2019-05-13 17:16:15.000000000 -0700
+++ new/src/java.base/share/classes/java/util/List.java	2019-05-13 17:16:15.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
@@ -292,7 +292,8 @@
 
     /**
      * Returns {@code true} if this list contains all of the elements of the
-     * specified collection.
+     * specified collection. This operation uses the membership semantics
+     * of this list.
      *
      * @param  c collection to be checked for containment in this list
      * @return {@code true} if this list contains all of the elements of the
@@ -364,7 +365,11 @@
 
     /**
      * Removes from this list all of its elements that are contained in the
-     * specified collection (optional operation).
+     * specified collection (optional operation). This operation uses the
+     * membership semantics of the specified collection.
+     *
+     * @implNote
+     * {@inheritDoc}
      *
      * @param c collection containing elements to be removed from this list
      * @return {@code true} if this list changed as a result of the call
@@ -386,7 +391,11 @@
      * Retains only the elements in this list that are contained in the
      * specified collection (optional operation).  In other words, removes
      * from this list all of its elements that are not contained in the
-     * specified collection.
+     * specified collection. This operation uses the membership semantics of
+     * the specified collection.
+     *
+     * @implNote
+     * {@inheritDoc}
      *
      * @param c collection containing elements to be retained in this list
      * @return {@code true} if this list changed as a result of the call
@@ -528,10 +537,10 @@
      * {@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 Objects.equals(e1, e2)}.)
-     * In other words, two lists are defined to be
+     * {@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 equals method works properly across
+     * definition ensures that the {@code equals} method works properly across
      * different implementations of the {@code List} interface.
      *
      * @param o the object to be compared for equality with this list