--- 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}.