--- jsr166/src/main/java/util/Queue.java	2003/10/19 13:38:29	1.21
+++ jsr166/src/main/java/util/Queue.java	2004/11/21 01:40:39	1.23
@@ -1,7 +1,7 @@
 /*
  * Written by Doug Lea with assistance from members of JCP JSR-166
- * Expert Group and released to the public domain. Use, modify, and
- * redistribute this code in any way without acknowledgement.
+ * Expert Group and released to the public domain, as explained at
+ * http://creativecommons.org/licenses/publicdomain
  */
 
 package java.util;
@@ -9,7 +9,31 @@ package java.util;
 /**
  * A collection designed for holding elements prior to processing.
  * Besides basic {@link java.util.Collection Collection} operations, queues provide
- * additional insertion, extraction, and inspection operations.
+ * additional insertion, extraction, and inspection operations. The names
+ * of the operations vary with their policies:
+ *
+ *<table BORDER CELLPADDING=3 CELLSPACING=1>
+ *  <tr>
+ *    <td><em>Operation</em></td>
+ *    <td ALIGN=CENTER><em>Attempt</em></td>
+ *    <td ALIGN=CENTER><em>Throw</em></td>
+ *  </tr>
+ *  <tr>
+ *    <td><em>insert</em></td>
+ *    <td>offer(x)</td>
+ *    <td>add(x)</td>
+ *  </tr>
+ *  <tr>
+ *    <td><em>extract</em></td>
+ *    <td>poll()</td>
+ *    <td>remove()</td>
+ *  </tr>
+ *  <tr>
+ *    <td><em>inspect</em></td>
+ *    <td>peek()</td>
+ *    <td>element()</td>
+ *  </tr>
+ *</table>
  *
  * <p>Queues typically, but do not necessarily, order elements in a
  * FIFO (first-in-first-out) manner.  Among the exceptions are