--- jsr166/src/main/java/util/Queue.java 2003/07/31 19:49:42 1.11
+++ jsr166/src/main/java/util/Queue.java 2003/08/06 01:57:53 1.15
@@ -20,8 +20,9 @@ package java.util;
* which would be removed by a call to {@link #remove() } or {@link #poll()}.
* Every Queue implementation must specify its ordering guarantees.
*
- *
The {@link #offer(E)} method adds an element if possible, otherwise
- * returning false. This differs from the {@link java.util.Collection#add Collection.add(E)}
+ *
The {@link #offer offer} method adds an element if possible, otherwise
+ * returning false. This differs from the
+ * {@link java.util.Collection#add Collection.add}
* method, which throws an unchecked exception upon
* failure. It is designed for use in collections in which failure to
* add is a normal, rather than exceptional occurrence, for example,
@@ -60,7 +61,7 @@ package java.util;
* @see java.util.Collection
* @see LinkedList
* @see PriorityQueue
- * @see java.util.concurrent.LinkedQueue
+ * @see java.util.concurrent.LinkedBlockingQueue
* @see java.util.concurrent.BlockingQueue
* @see java.util.concurrent.ArrayBlockingQueue
* @see java.util.concurrent.LinkedBlockingQueue
@@ -71,7 +72,7 @@ package java.util;
public interface Queue extends Collection {
/**
- * Add the specified element to this queue, if possible.
+ * Adds the specified element to this queue, if possible.
*
* @param o the element to add.
* @return true if it was possible to add the element to
@@ -80,7 +81,7 @@ public interface Queue extends Collec
boolean offer(E o);
/**
- * Retrieve and remove the head of this queue, if it is available.
+ * Retrieves and removes the head of this queue, if it is available.
*
* @return the head of this queue, or null if this
* queue is empty.
@@ -88,7 +89,7 @@ public interface Queue extends Collec
E poll();
/**
- * Retrieve and remove the head of this queue.
+ * Retrieves and removes the head of this queue.
* This method differs
* from the poll method in that it throws an exception if this
* queue is empty.
@@ -99,7 +100,7 @@ public interface Queue extends Collec
E remove();
/**
- * Retrieve, but do not remove, the head of this queue.
+ * Retrieves, but does not remove, the head of this queue.
* This method differs from the poll
* method only in that this method does not remove the head element from
* this queue.
@@ -109,7 +110,7 @@ public interface Queue extends Collec
E peek();
/**
- * Retrieve, but do not remove, the head of this queue. This method
+ * Retrieves, but does not remove, the head of this queue. This method
* differs from the peek method only in that it throws an
* exception if this queue is empty.
*