--- jsr166/src/jsr166x/NavigableMap.java	2004/12/26 20:13:15	1.4
+++ jsr166/src/jsr166x/NavigableMap.java	2009/11/16 04:16:42	1.5
@@ -28,7 +28,7 @@ import java.util.*;
  * 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 <tt>SubMap</tt>.
- * 
+ *
  * <p>This interface additionally defines methods <tt>firstEntry</tt>,
  * <tt>pollFirstEntry</tt>, <tt>lastEntry</tt>, and
  * <tt>pollLastEntry</tt> that return and/or remove the least and
@@ -43,14 +43,14 @@ import java.util.*;
  *
  * @author Doug Lea
  * @param <K> the type of keys maintained by this map
- * @param <V> the type of mapped values 
+ * @param <V> the type of mapped values
  */
 public interface NavigableMap<K,V> extends SortedMap<K,V> {
     /**
      * Returns a key-value mapping associated with the least key
      * greater than or equal to the given key, or <tt>null</tt> if there is
-     * no such entry. 
-     * 
+     * no such entry.
+     *
      * @param key the key.
      * @return an Entry associated with ceiling of given key, or <tt>null</tt>
      * if there is no such Entry.
@@ -64,7 +64,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns least key greater than or equal to the given key, or
      * <tt>null</tt> if there is no such key.
-     * 
+     *
      * @param key the key.
      * @return the ceiling key, or <tt>null</tt>
      * if there is no such key.
@@ -78,8 +78,8 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns a key-value mapping associated with the greatest
      * key strictly less than the given key, or <tt>null</tt> if there is no
-     * such entry. 
-     * 
+     * such entry.
+     *
      * @param key the key.
      * @return an Entry with greatest key less than the given
      * key, or <tt>null</tt> if there is no such Entry.
@@ -93,7 +93,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns the greatest key strictly less than the given key, or
      * <tt>null</tt> if there is no such key.
-     * 
+     *
      * @param key the key.
      * @return the greatest key less than the given
      * key, or <tt>null</tt> if there is no such key.
@@ -108,7 +108,7 @@ public interface NavigableMap<K,V> exten
      * Returns a key-value mapping associated with the greatest key
      * less than or equal to the given key, or <tt>null</tt> if there
      * is no such entry.
-     * 
+     *
      * @param key the key.
      * @return an Entry associated with floor of given key, or <tt>null</tt>
      * if there is no such Entry.
@@ -123,7 +123,7 @@ public interface NavigableMap<K,V> exten
      * Returns the greatest key
      * less than or equal to the given key, or <tt>null</tt> if there
      * is no such key.
-     * 
+     *
      * @param key the key.
      * @return the floor of given key, or <tt>null</tt> if there is no
      * such key.
@@ -138,7 +138,7 @@ public interface NavigableMap<K,V> exten
      * Returns a key-value mapping associated with the least key
      * strictly greater than the given key, or <tt>null</tt> if there
      * is no such entry.
-     * 
+     *
      * @param key the key.
      * @return an Entry with least key greater than the given key, or
      * <tt>null</tt> if there is no such Entry.
@@ -152,7 +152,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns the least key strictly greater than the given key, or
      * <tt>null</tt> if there is no such key.
-     * 
+     *
      * @param key the key.
      * @return the least key greater than the given key, or
      * <tt>null</tt> if there is no such key.
@@ -166,8 +166,8 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns a key-value mapping associated with the least
      * key in this map, or <tt>null</tt> if the map is empty.
-     * 
-     * @return an Entry with least key, or <tt>null</tt> 
+     *
+     * @return an Entry with least key, or <tt>null</tt>
      * if the map is empty.
      */
     public Map.Entry<K,V> firstEntry();
@@ -175,7 +175,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Returns a key-value mapping associated with the greatest
      * key in this map, or <tt>null</tt> if the map is empty.
-     * 
+     *
      * @return an Entry with greatest key, or <tt>null</tt>
      * if the map is empty.
      */
@@ -184,7 +184,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Removes and returns a key-value mapping associated with
      * the least key in this map, or <tt>null</tt> if the map is empty.
-     * 
+     *
      * @return the removed first entry of this map, or <tt>null</tt>
      * if the map is empty.
      */
@@ -193,7 +193,7 @@ public interface NavigableMap<K,V> exten
     /**
      * Removes and returns a key-value mapping associated with
      * the greatest key in this map, or <tt>null</tt> if the map is empty.
-     * 
+     *
      * @return the removed last entry of this map, or <tt>null</tt>
      * if the map is empty.
      */
@@ -265,7 +265,7 @@ public interface NavigableMap<K,V> exten
      * Returns a view of the portion of this map whose keys are strictly less
      * than <tt>toKey</tt>.  The returned sorted map is backed by this map, so
      * changes in the returned sorted map are reflected in this map, and
-     * vice-versa.  
+     * 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 <tt>toKey</tt>.