--- jsr166/src/main/java/util/Queue.java 2003/05/27 18:20:06 1.3 +++ jsr166/src/main/java/util/Queue.java 2003/06/07 18:31:00 1.4 @@ -23,10 +23,14 @@ package java.util; * failure. It is designed for use in collections in which failure to * add is a normal, rather than exceptional occurrence, for example, * in fixed-capacity (or “bounded”) queues. + * *

The {@link #remove()} and {@link #poll()} methods remove and return an - * element in accord with the implementation's ordering policy. For example, - * in FIFO queues, they remove and return the oldest element in the queue. + * element in accord with the implementation's ordering policy. + * Exactly which element is removed from the queue is a function + * of the queue's ordering policy, which differs from implementation + * to implementation. Possible orderings include (but are not limited + * to) first-in-first-out (FIFO), element priority, and arbitrary. * The remove() and poll() methods differ only in their * behavior when the queue is empty: the remove() method throws an * exception, while the poll() method returns null. @@ -71,10 +75,6 @@ public interface Queue extends Collec /** * Remove and return an element from the queue if one is available. - * Exactly which element is removed from the queue is a function - * of the queue's ordering policy, which differs from implementation - * to implementation. Possible orderings include (but are not limited - * to) first-in-first-out (FIFO), element priority, and arbitrary. * * @return an element previously on the queue, or null if the * queue is empty.