--- jsr166/src/jsr166x/NavigableMap.java 2004/12/21 17:27:44 1.3 +++ jsr166/src/jsr166x/NavigableMap.java 2004/12/26 20:13:15 1.4 @@ -9,23 +9,22 @@ package jsr166x; import java.util.*; /** - * A {@link SortedMap} extended with navigation methods returning - * key-value pairs holding the closest matches for given search - * targets. Methods lowerEntry, floorEntry, - * ceilingEntry, and higherEntry return - * Map.Entry objects associated with keys respectively less - * than, less than or equal, greater than or equal, and greater than a - * given key, returning null if there is no such key. - * Similarly, methods lowerKey, floorKey, - * ceilingKey, and higherKey return only the - * associated keys. All of these methods are designed for locating, - * not traversing entries. + * A {@link SortedMap} extended with navigation methods returning the + * closest matches for given search targets. Methods + * lowerEntry, floorEntry, ceilingEntry, + * and higherEntry return Map.Entry objects + * associated with keys respectively less than, less than or equal, + * greater than or equal, and greater than a given key, returning + * null if there is no such key. Similarly, methods + * lowerKey, floorKey, ceilingKey, and + * higherKey return only the associated keys. All of these + * methods are designed for locating, not traversing entries. * *

A NavigableMap may be viewed and traversed in either * ascending or descending key order. The Map methods - * keySet and entrySet) return ascending views, and + * keySet and entrySet return ascending views, and * the additional methods descendingKeySet and - * descendingEntrySet) return descending views. The + * descendingEntrySet return descending views. The * performance of ascending traversals is likely to be faster than * descending traversals. Notice that it is possible to perform * subrannge traversals in either direction using SubMap. @@ -220,7 +219,7 @@ public interface NavigableMap exten /** * Returns a set view of the mappings contained in this map, in * descending key order. Each element in the returned set is a - * {@link Map.Entry}. The set is backed by the map, so changes to + * Map.Entry. The set is backed by the map, so changes to * the map are reflected in the set, and vice-versa. If the map * is modified while an iteration over the set is in progress * (except through the iterator's own remove operation,