--- jsr166/src/main/java/util/Deque.java 2005/05/17 16:14:34 1.12 +++ jsr166/src/main/java/util/Deque.java 2005/06/18 01:56:01 1.14 @@ -5,6 +5,7 @@ */ package java.util; +import java.util.*; // for javadoc /** * A linear collection that supports element insertion and removal at @@ -182,11 +183,13 @@ public interface Deque extends Queue< void addFirst(E e); /** - * Inserts the specified element at the end of this deque if it is + * Inserts the specified element at the end of this deque if it is * possible to do so immediately without violating capacity restrictions. * When using a capacity-restricted deque, it is generally preferable to * use method {@link #offerLast}. * + *

This method is equivalent to {@link #add}. + * * @param e the element to add * @throws IllegalStateException if the element cannot be added at this * time due to capacity restrictions @@ -354,7 +357,7 @@ public interface Deque extends Queue< * When using a capacity-restricted deque, it is generally preferable to * use {@link #offer(Object) offer}. * - *

This method is equivalent to {@link #addLast(Object) addLast}. + *

This method is equivalent to {@link #addLast}. * * @param e the element to add * @return true (as per the spec for {@link Collection#add})