--- jsr166/src/jsr166x/ConcurrentNavigableMap.java 2012/12/29 23:55:19 1.6 +++ jsr166/src/jsr166x/ConcurrentNavigableMap.java 2013/01/16 00:51:11 1.7 @@ -19,8 +19,8 @@ import java.util.concurrent.*; public interface ConcurrentNavigableMap extends ConcurrentMap, NavigableMap { /** * Returns a view of the portion of this map whose keys range from - * fromKey, inclusive, to toKey, exclusive. (If - * fromKey and toKey are equal, the returned sorted map + * {@code fromKey}, inclusive, to {@code toKey}, exclusive. (If + * {@code fromKey} and {@code toKey} are equal, the returned sorted map * is empty.) The returned sorted map is backed by this map, so changes * in the returned sorted map are reflected in this map, and vice-versa. * @@ -28,50 +28,50 @@ public interface ConcurrentNavigableMap< * @param toKey high endpoint (exclusive) of the subMap * * @return a view of the portion of this map whose keys range from - * fromKey, inclusive, to toKey, exclusive + * {@code fromKey}, inclusive, to {@code toKey}, exclusive * - * @throws ClassCastException if fromKey and - * toKey cannot be compared to one another using this + * @throws ClassCastException if {@code fromKey} and + * {@code toKey} cannot be compared to one another using this * map's comparator (or, if the map has no comparator, using * natural ordering) - * @throws IllegalArgumentException if fromKey is greater - * than toKey - * @throws NullPointerException if fromKey or - * toKey is null and this map does not support - * null keys + * @throws IllegalArgumentException if {@code fromKey} is greater + * than {@code toKey} + * @throws NullPointerException if {@code fromKey} or + * {@code toKey} is {@code null} and this map does not support + * {@code null} keys */ public ConcurrentNavigableMap subMap(K fromKey, K toKey); /** * Returns a view of the portion of this map whose keys are strictly less - * than toKey. The returned sorted map is backed by this map, so + * than {@code toKey}. The returned sorted map is backed by this map, so * changes in the returned sorted map are reflected in this map, and * vice-versa. * @param toKey high endpoint (exclusive) of the headMap * @return a view of the portion of this map whose keys are strictly - * less than toKey + * less than {@code toKey} * - * @throws ClassCastException if toKey is not compatible + * @throws ClassCastException if {@code toKey} is not compatible * with this map's comparator (or, if the map has no comparator, - * if toKey does not implement Comparable) - * @throws NullPointerException if toKey is null - * and this map does not support null keys + * if {@code toKey} does not implement {@code Comparable}) + * @throws NullPointerException if {@code toKey} is {@code null} + * and this map does not support {@code null} keys */ public ConcurrentNavigableMap headMap(K toKey); /** * Returns a view of the portion of this map whose keys are - * greater than or equal to fromKey. The returned sorted + * greater than or equal to {@code fromKey}. The returned sorted * map is backed by this map, so changes in the returned sorted * map are reflected in this map, and vice-versa. * @param fromKey low endpoint (inclusive) of the tailMap * @return a view of the portion of this map whose keys are greater - * than or equal to fromKey - * @throws ClassCastException if fromKey is not compatible + * than or equal to {@code fromKey} + * @throws ClassCastException if {@code fromKey} is not compatible * with this map's comparator (or, if the map has no comparator, - * if fromKey does not implement Comparable) - * @throws NullPointerException if fromKey is null - * and this map does not support null keys + * if {@code fromKey} does not implement {@code Comparable}) + * @throws NullPointerException if {@code fromKey} is {@code null} + * and this map does not support {@code null} keys */ public ConcurrentNavigableMap tailMap(K fromKey); }