--- jsr166/src/main/java/util/NavigableMap.java 2005/03/22 01:30:10 1.3 +++ jsr166/src/main/java/util/NavigableMap.java 2005/03/22 16:48:32 1.4 @@ -25,7 +25,11 @@ package java.util; * descendingEntrySet return descending views. The * performance of ascending traversals is likely to be faster than * descending traversals. Notice that it is possible to perform - * subrange traversals in either direction using SubMap. + * subrange traversals in either direction using navigableSubMap. + * Methods navigableSubMap, navigableHeadMap, and + * navigableTailMap differ from the similarly named + * SortedMap methods only in that the returned maps + * are guaranteed to obey the NavigableMap interface. * *

This interface additionally defines methods firstEntry, * pollFirstEntry, lastEntry, and @@ -240,10 +244,7 @@ public interface NavigableMap exten * fromKey and toKey are equal, the returned * navigable map is empty.) The returned navigable map is backed * by this map, so changes in the returned navigable map are - * reflected in this map, and vice-versa. Note: This - * method differs from SortedMap.subMap only - * in that the returned map is guaranteed to support the - * NavigableMap interface. + * reflected in this map, and vice-versa. * * @param fromKey low endpoint (inclusive) of the subMap. * @param toKey high endpoint (exclusive) of the subMap.