--- jsr166/src/main/java/util/Queue.java 2003/12/27 19:26:15 1.22
+++ jsr166/src/main/java/util/Queue.java 2004/11/21 01:40:39 1.23
@@ -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:
+ *
+ *
+ *
+ * | Operation |
+ * Attempt |
+ * Throw |
+ *
+ *
+ * | insert |
+ * offer(x) |
+ * add(x) |
+ *
+ *
+ * | extract |
+ * poll() |
+ * remove() |
+ *
+ *
+ * | inspect |
+ * peek() |
+ * element() |
+ *
+ *
*
* Queues typically, but do not necessarily, order elements in a
* FIFO (first-in-first-out) manner. Among the exceptions are