--- jsr166/src/main/java/util/Queue.java	2003/09/12 15:38:26	1.17
+++ jsr166/src/main/java/util/Queue.java	2003/10/19 13:38:29	1.21
@@ -79,11 +79,12 @@ package java.util;
  * @see java.util.concurrent.PriorityBlockingQueue
  * @since 1.5
  * @author Doug Lea
+ * @param <E> the type of elements held in this collection
  */
 public interface Queue<E> extends Collection<E> {
 
     /**
-     * Inserts the specified element to this queue, if possible.  When
+     * Inserts the specified element into this queue, if possible.  When
      * using queues that may impose insertion restrictions (for
      * example capacity bounds), method <tt>offer</tt> is generally
      * preferable to method {@link Collection#add}, which can fail to
@@ -96,7 +97,8 @@ public interface Queue<E> extends Collec
     boolean offer(E o);
 
     /**
-     * Retrieves and removes the head of this queue, if it is available.
+     * Retrieves and removes the head of this queue, or <tt>null</tt>
+     * if this queue is empty.
      *
      * @return the head of this queue, or <tt>null</tt> if this
      *         queue is empty.
@@ -104,10 +106,9 @@ public interface Queue<E> extends Collec
     E poll();
 
     /**
-     * Retrieves and removes the head of this queue.
-     * This method differs
-     * from the <tt>poll</tt> method in that it throws an exception if this
-     * queue is empty.
+     * Retrieves and removes the head of this queue.  This method
+     * differs from the <tt>poll</tt> method in that it throws an
+     * exception if this queue is empty.
      *
      * @return the head of this queue.
      * @throws NoSuchElementException if this queue is empty.
@@ -115,12 +116,11 @@ public interface Queue<E> extends Collec
     E remove();
 
     /**
-     * Retrieves, but does not remove, the head of this queue.
-     * This method differs from the <tt>poll</tt>
-     * method only in that this method does not remove the head element from
-     * this queue.
+     * Retrieves, but does not remove, the head of this queue,
+     * returning <tt>null</tt> if this queue is empty.
      *
-     * @return the head of this queue, or <tt>null</tt> if this queue is empty.
+     * @return the head of this queue, or <tt>null</tt> if this queue
+     * is empty.
      */
     E peek();