--- jsr166/src/main/java/util/Queue.java 2003/07/28 19:53:49 1.9 +++ jsr166/src/main/java/util/Queue.java 2003/07/31 07:18:02 1.10 @@ -18,7 +18,7 @@ package java.util; * stacks) which order the elements LIFO (last-in-first-out). * Whatever the ordering used, the head of the queue is that element * which would be removed by a call to {@link #remove() } or {@link #poll()}. - * Every Queue implementation must specify its ordering guarantees. + * 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 @@ -37,7 +37,7 @@ package java.util; * while the poll() method returns null. * *

The {@link #element()} and {@link #peek()} methods return, but do - * not delete, the head of the queue. + * not remove, the head of the queue. * *

The Queue interface does not define the blocking queue * methods, which are common in concurrent programming. These methods, @@ -73,11 +73,11 @@ public interface Queue extends Collec /** * Add the specified element to this queue, if possible. * - * @param element the element to add. + * @param o the element to add. * @return true if it was possible to add the element to - * this queue. + * this queue, else false */ - boolean offer(E element); + boolean offer(E o); /** * Retrieve and remove the head of this queue, if it is available. @@ -90,7 +90,7 @@ public interface Queue extends Collec /** * Retrieve and remove the head of this queue. * This method differs - * from the poll method in that it throws an exception if the + * from the poll method in that it throws an exception if this * queue is empty. * * @return the head of this queue. @@ -99,9 +99,9 @@ public interface Queue extends Collec E remove(); /** - * Retrieve, but do not remove, the head of this queue, or null - * if this queue is empty. This method differs from the poll - * method only in that this method does not remove the element from + * Retrieve, but do 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. * * @return the head of this queue, or null if this queue is empty.