--- jsr166/src/main/java/util/NavigableMap.java 2013/03/09 01:51:15 1.28 +++ jsr166/src/main/java/util/NavigableMap.java 2017/05/06 06:49:46 1.31 @@ -19,16 +19,18 @@ package java.util; * methods are designed for locating, not traversing entries. * *

A {@code NavigableMap} may be accessed and traversed in either - * ascending or descending key order. The {@code descendingMap} + * ascending or descending key order. The {@link #descendingMap} * method returns a view of the map with the senses of all relational * and directional methods inverted. The performance of ascending * operations and views is likely to be faster than that of descending - * ones. Methods {@code subMap}, {@code headMap}, - * and {@code tailMap} differ from the like-named {@code - * SortedMap} methods in accepting additional arguments describing - * whether lower and upper bounds are inclusive versus exclusive. - * Submaps of any {@code NavigableMap} must implement the {@code - * NavigableMap} interface. + * ones. Methods + * {@link #subMap(Object, boolean, Object, boolean) subMap(K, boolean, K, boolean)}, + * {@link #headMap(Object, boolean) headMap(K, boolean)}, and + * {@link #tailMap(Object, boolean) tailMap(K, boolean)} + * differ from the like-named {@code SortedMap} methods in accepting + * additional arguments describing whether lower and upper bounds are + * inclusive versus exclusive. Submaps of any {@code NavigableMap} + * must implement the {@code NavigableMap} interface. * *

This interface additionally defines methods {@link #firstEntry}, * {@link #pollFirstEntry}, {@link #lastEntry}, and @@ -51,10 +53,10 @@ package java.util; * implement {@code NavigableMap}, but extensions and implementations * of this interface are encouraged to override these methods to return * {@code NavigableMap}. Similarly, - * {@link #keySet()} can be overridden to return {@code NavigableSet}. + * {@link #keySet()} can be overridden to return {@link NavigableSet}. * *

This interface is a member of the - * + * * Java Collections Framework. * * @author Doug Lea @@ -269,7 +271,7 @@ public interface NavigableMap exten * Returns a view of the portion of this map whose keys range from * {@code fromKey} to {@code toKey}. If {@code fromKey} and * {@code toKey} are equal, the returned map is empty unless - * {@code fromExclusive} and {@code toExclusive} are both true. The + * {@code fromInclusive} and {@code toInclusive} are both true. The * returned map is backed by this map, so changes in the returned map are * reflected in this map, and vice-versa. The returned map supports all * optional map operations that this map supports.