--- jsr166/src/main/java/util/NavigableMap.java 2005/05/16 06:27:52 1.8 +++ jsr166/src/main/java/util/NavigableMap.java 2005/07/20 02:18:52 1.11 @@ -5,6 +5,7 @@ */ package java.util; +import java.util.*; // for javadoc (till 6280605 is fixed) /** * A {@link SortedMap} extended with navigation methods returning the @@ -28,8 +29,9 @@ package java.util; * 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. + * SortedMap methods only in their declared return types. + * Submaps of any NavigableMap must implement the + * NavigableMap interface. * *

This interface additionally defines methods firstEntry, * pollFirstEntry, lastEntry, and @@ -215,8 +217,8 @@ public interface NavigableMap exten * the iteration are undefined. The set supports element removal, * which removes the corresponding mapping from the map, via the * Iterator.remove, Set.remove, - * removeAll retainAll, and clear - * operations. It does not support the add or addAll + * removeAll, retainAll, and clear + * operations. It does not support the add or addAll * operations. * * @return a set view of the keys contained in this map, sorted in