--- jsr166/src/main/java/util/NavigableSet.java 2005/03/22 01:30:10 1.3 +++ jsr166/src/main/java/util/NavigableSet.java 2005/03/22 16:48:32 1.4 @@ -21,6 +21,10 @@ package java.util; * additionally defines methods pollFirst and * pollLast that return and remove the lowest and highest key, * if one exists, else returning null. + * Methods navigableSubSet, navigableHeadSet, and + * navigableTailSet differ from the similarly named + * SortedSet methods only in that the returned sets + * are guaranteed to obey the NavigableSet interface. * *

The return values of navigation methods may be ambiguous in * implementations that permit null elements. However, even @@ -118,10 +122,7 @@ public interface NavigableSet extends * exclusive. (If fromElement and toElement are * equal, the returned navigable set is empty.) The returned * navigable set is backed by this set, so changes in the returned - * navigable set are reflected in this set, and vice-versa. Note: - * This method differs from SortedSet.subSet only in that - * the returned set is guaranteed to support the - * NavigableSet interface. + * navigable set are reflected in this set, and vice-versa. * * @param fromElement low endpoint (inclusive) of the subSet. * @param toElement high endpoint (exclusive) of the subSet.