--- jsr166/src/jsr166y/TransferQueue.java	2009/07/27 00:01:47	1.6
+++ jsr166/src/jsr166y/TransferQueue.java	2009/07/31 07:30:29	1.8
@@ -39,9 +39,10 @@ import java.util.concurrent.*;
  */
 public interface TransferQueue<E> extends BlockingQueue<E> {
     /**
-     * Transfers the specified element if there exists a consumer
-     * already waiting to receive it, otherwise returning {@code false}
-     * without enqueuing the element.
+     * Transfers the specified element immediately if there exists a
+     * consumer already waiting to receive it (in {@link #take} or
+     * timed {@link #poll(long,TimeUnit) poll}), otherwise returning
+     * {@code false} without enqueuing the element.
      *
      * @param e the element to transfer
      * @return {@code true} if the element was transferred, else
@@ -57,7 +58,7 @@ public interface TransferQueue<E> extend
     /**
      * Inserts the specified element into this queue, waiting if
      * necessary for space to become available and the element to be
-     * dequeued by a consumer invoking {@code take} or {@code poll}.
+     * received by a consumer invoking {@code take} or {@code poll}.
      *
      * @param e the element to transfer
      * @throws InterruptedException if interrupted while waiting,
@@ -73,7 +74,7 @@ public interface TransferQueue<E> extend
     /**
      * Inserts the specified element into this queue, waiting up to
      * the specified wait time if necessary for space to become
-     * available and the element to be dequeued by a consumer invoking
+     * available and the element to be received by a consumer invoking
      * {@code take} or {@code poll}.
      *
      * @param e the element to transfer
@@ -97,7 +98,8 @@ public interface TransferQueue<E> extend
 
     /**
      * Returns {@code true} if there is at least one consumer waiting
-     * to dequeue an element via {@code take} or {@code poll}.
+     * to receive an element via {@link #take} or
+     * timed {@link #poll(long,TimeUnit) poll}.
      * The return value represents a momentary state of affairs.
      *
      * @return {@code true} if there is at least one waiting consumer
@@ -106,15 +108,16 @@ public interface TransferQueue<E> extend
 
     /**
      * Returns an estimate of the number of consumers waiting to
-     * dequeue elements via {@code take} or {@code poll}. The return
-     * value is an approximation of a momentary state of affairs, that
-     * may be inaccurate if consumers have completed or given up
-     * waiting. The value may be useful for monitoring and heuristics,
-     * but not for synchronization control. Implementations of this
+     * receive elements via {@link #take} or timed
+     * {@link #poll(long,TimeUnit) poll}.  The return value is an
+     * approximation of a momentary state of affairs, that may be
+     * inaccurate if consumers have completed or given up waiting.
+     * The value may be useful for monitoring and heuristics, but
+     * not for synchronization control.  Implementations of this
      * method are likely to be noticeably slower than those for
      * {@link #hasWaitingConsumer}.
      *
-     * @return the number of consumers waiting to dequeue elements
+     * @return the number of consumers waiting to receive elements
      */
     int getWaitingConsumerCount();
 }