--- jsr166/src/main/java/util/Deque.java	2005/05/16 04:58:20	1.9
+++ jsr166/src/main/java/util/Deque.java	2005/05/17 16:00:48	1.11
@@ -206,8 +206,8 @@ public interface Deque<E> extends Queue<
      * which can fail to insert an element only by throwing an exception.
      *
      * @param e the element to add
-     * @return <tt>true</tt> if it was possible to insert the element,
-     *         else <tt>false</tt>
+     * @return <tt>true</tt> if the element was added to this deque, else
+     *         <tt>false</tt>
      * @throws ClassCastException if the class of the specified element
      *         prevents it from being added to this deque
      * @throws NullPointerException if the specified element is null and this
@@ -224,8 +224,8 @@ public interface Deque<E> extends Queue<
      * which can fail to insert an element only by throwing an exception.
      *
      * @param e the element to add
-     * @return <tt>true</tt> if it was possible to insert the element,
-     *         else <tt>false</tt>
+     * @return <tt>true</tt> if the element was added to this deque, else
+     *         <tt>false</tt>
      * @throws ClassCastException if the class of the specified element
      *         prevents it from being added to this deque
      * @throws NullPointerException if the specified element is null and this
@@ -524,10 +524,10 @@ public interface Deque<E> extends Queue<
     public int size();
 
     /**
-     * Returns an iterator over the elements in this deque.  The elements
-     * will be ordered from first (head) to last (tail).
+     * Returns an iterator over the elements in this deque in proper sequence.
+     * The elements will be returned in order from first (head) to last (tail).
      *
-     * @return an <tt>Iterator</tt> over the elements in this deque
+     * @return an iterator over the elements in this deque in proper sequence
      */
     Iterator<E> iterator();
 }