diff --git a/src/java.base/share/classes/java/util/List.java b/src/java.base/share/classes/java/util/List.java index 8dec9acd6c5..8ba368bf6f6 100644 --- a/src/java.base/share/classes/java/util/List.java +++ b/src/java.base/share/classes/java/util/List.java @@ -442,7 +442,8 @@ public interface List extends Collection { /** * Sorts this list according to the order induced by the specified - * {@link Comparator}. + * {@link Comparator}. The sort is stable: this method must not + * reorder equal elements. * *

All elements in this list must be mutually comparable using the * specified comparator (that is, {@code c.compare(e1, e2)} must not throw