--- a/src/java.base/share/classes/java/util/List.java	Fri Nov 17 15:43:12 2017 +0100
+++ b/src/java.base/share/classes/java/util/List.java	Fri Nov 17 09:29:47 2017 -0800
@@ -442,7 +442,8 @@
 
     /**
      * Sorts this list according to the order induced by the specified
-     * {@link Comparator}.
+     * {@link Comparator}.  The sort is <i>stable</i>: this method must not
+     * reorder equal elements.
      *
      * <p>All elements in this list must be <i>mutually comparable</i> using the
      * specified comparator (that is, {@code c.compare(e1, e2)} must not throw