--- jsr166/src/main/java/util/Deque.java 2013/02/11 17:27:45 1.24 +++ jsr166/src/main/java/util/Deque.java 2013/07/20 18:00:11 1.26 @@ -44,24 +44,24 @@ package java.util; * * * Insert - * {@link #addFirst addFirst(e)} - * {@link #offerFirst offerFirst(e)} - * {@link #addLast addLast(e)} - * {@link #offerLast offerLast(e)} + * {@link Deque#addFirst addFirst(e)} + * {@link Deque#offerFirst offerFirst(e)} + * {@link Deque#addLast addLast(e)} + * {@link Deque#offerLast offerLast(e)} * * * Remove - * {@link #removeFirst removeFirst()} - * {@link #pollFirst pollFirst()} - * {@link #removeLast removeLast()} - * {@link #pollLast pollLast()} + * {@link Deque#removeFirst removeFirst()} + * {@link Deque#pollFirst pollFirst()} + * {@link Deque#removeLast removeLast()} + * {@link Deque#pollLast pollLast()} * * * Examine - * {@link #getFirst getFirst()} - * {@link #peekFirst peekFirst()} - * {@link #getLast getLast()} - * {@link #peekLast peekLast()} + * {@link Deque#getFirst getFirst()} + * {@link Deque#peekFirst peekFirst()} + * {@link Deque#getLast getLast()} + * {@link Deque#peekLast peekLast()} * * * @@ -167,9 +167,10 @@ package java.util; public interface Deque extends Queue { /** * Inserts the specified element at the front 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 #offerFirst}. + * possible to do so immediately without violating capacity restrictions, + * throwing an {@code IllegalStateException} if no space is currently + * available. When using a capacity-restricted deque, it is generally + * preferable to use method {@link #offerFirst}. * * @param e the element to add * @throws IllegalStateException if the element cannot be added at this @@ -185,9 +186,10 @@ public interface Deque extends Queue< /** * 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}. + * possible to do so immediately without violating capacity restrictions, + * throwing an {@code IllegalStateException} if no space is currently + * available. When using a capacity-restricted deque, it is generally + * preferable to use method {@link #offerLast}. * *

This method is equivalent to {@link #add}. * @@ -453,8 +455,7 @@ public interface Deque extends Queue< /** * Pushes an element onto the stack represented by this deque (in other * words, at the head of this deque) if it is possible to do so - * immediately without violating capacity restrictions, returning - * {@code true} upon success and throwing an + * immediately without violating capacity restrictions, throwing an * {@code IllegalStateException} if no space is currently available. * *

This method is equivalent to {@link #addFirst}.