--- jsr166/src/main/java/util/PriorityQueue.java	2004/04/11 04:50:24	1.48
+++ jsr166/src/main/java/util/PriorityQueue.java	2004/05/27 11:05:44	1.49
@@ -325,6 +325,10 @@ public class PriorityQueue<E> extends Ab
         return offer(o);
     }
 
+    /**
+     * Removes a single instance of the specified element from this
+     * collection, if it is present.
+     */
     public boolean remove(Object o) {
         if (o == null)
             return false;
@@ -456,7 +460,8 @@ public class PriorityQueue<E> extends Ab
     }
 
     /**
-     * Remove all elements from the priority queue.
+     * Removes all elements from the priority queue.
+     * The queue will be empty after this call returns.
      */
     public void clear() {
         modCount++;