--- jsr166/src/jsr166x/BlockingDeque.java 2012/12/30 02:05:53 1.6
+++ jsr166/src/jsr166x/BlockingDeque.java 2013/01/16 00:51:11 1.7
@@ -43,17 +43,17 @@ import java.util.*;
*
*
*
- *
Like any {@link BlockingQueue}, a BlockingDeque is
+ *
Like any {@link BlockingQueue}, a {@code BlockingDeque} is
* thread safe and may (or may not) be capacity-constrained. A
- * BlockingDeque implementation may be used directly as a
- * FIFO BlockingQueue. The blocking methods inherited from
- * the BlockingQueue interface are precisely equivalent to
- * BlockingDeque methods as indicated in the following table:
+ * {@code BlockingDeque} implementation may be used directly as a
+ * FIFO {@code BlockingQueue}. The blocking methods inherited from
+ * the {@code BlockingQueue} interface are precisely equivalent to
+ * {@code BlockingDeque} methods as indicated in the following table:
*
*
*
- * BlockingQueue Method |
- * Equivalent BlockingDeque Method |
+ * {@code BlockingQueue} Method |
+ * Equivalent {@code BlockingDeque} Method |
*
*
*
@@ -90,7 +90,7 @@ public interface BlockingDeque extend
* waiting if necessary for space to become available.
* @param o the element to add
* @throws InterruptedException if interrupted while waiting
- * @throws NullPointerException if the specified element is null
+ * @throws NullPointerException if the specified element is {@code null}
*/
void putFirst(E o) throws InterruptedException;
@@ -99,7 +99,7 @@ public interface BlockingDeque extend
* waiting if necessary for space to become available.
* @param o the element to add
* @throws InterruptedException if interrupted while waiting
- * @throws NullPointerException if the specified element is null
+ * @throws NullPointerException if the specified element is {@code null}
*/
void putLast(E o) throws InterruptedException;
@@ -125,13 +125,13 @@ public interface BlockingDeque extend
* become available.
* @param o the element to add
* @param timeout how long to wait before giving up, in units of
- * unit
- * @param unit a TimeUnit determining how to interpret the
- * timeout parameter
- * @return true if successful, or false if
+ * {@code unit}
+ * @param unit a {@code TimeUnit} determining how to interpret the
+ * {@code timeout} parameter
+ * @return {@code true} if successful, or {@code false} if
* the specified waiting time elapses before space is available
* @throws InterruptedException if interrupted while waiting
- * @throws NullPointerException if the specified element is null
+ * @throws NullPointerException if the specified element is {@code null}
*/
boolean offerFirst(E o, long timeout, TimeUnit unit)
throws InterruptedException;
@@ -142,13 +142,13 @@ public interface BlockingDeque extend
* become available.
* @param o the element to add
* @param timeout how long to wait before giving up, in units of
- * unit
- * @param unit a TimeUnit determining how to interpret the
- * timeout parameter
- * @return true if successful, or false if
+ * {@code unit}
+ * @param unit a {@code TimeUnit} determining how to interpret the
+ * {@code timeout} parameter
+ * @return {@code true} if successful, or {@code false} if
* the specified waiting time elapses before space is available
* @throws InterruptedException if interrupted while waiting
- * @throws NullPointerException if the specified element is null
+ * @throws NullPointerException if the specified element is {@code null}
*/
boolean offerLast(E o, long timeout, TimeUnit unit)
throws InterruptedException;
@@ -159,10 +159,10 @@ public interface BlockingDeque extend
* if necessary up to the specified wait time if no elements are
* present on this deque.
* @param timeout how long to wait before giving up, in units of
- * unit
- * @param unit a TimeUnit determining how to interpret the
- * timeout parameter
- * @return the head of this deque, or null if the
+ * {@code unit}
+ * @param unit a {@code TimeUnit} determining how to interpret the
+ * {@code timeout} parameter
+ * @return the head of this deque, or {@code null} if the
* specified waiting time elapses before an element is present
* @throws InterruptedException if interrupted while waiting
*/
@@ -174,10 +174,10 @@ public interface BlockingDeque extend
* if necessary up to the specified wait time if no elements are
* present on this deque.
* @param timeout how long to wait before giving up, in units of
- * unit
- * @param unit a TimeUnit determining how to interpret the
- * timeout parameter
- * @return the head of this deque, or null if the
+ * {@code unit}
+ * @param unit a {@code TimeUnit} determining how to interpret the
+ * {@code timeout} parameter
+ * @return the head of this deque, or {@code null} if the
* specified waiting time elapses before an element is present
* @throws InterruptedException if interrupted while waiting
*/
@@ -190,7 +190,7 @@ public interface BlockingDeque extend
* method is equivalent to putLast.
* @param o the element to add
* @throws InterruptedException if interrupted while waiting
- * @throws NullPointerException if the specified element is null
+ * @throws NullPointerException if the specified element is {@code null}
*/
void put(E o) throws InterruptedException;
@@ -198,15 +198,15 @@ public interface BlockingDeque extend
* Inserts the specified element as the lest element of this
* deque, if possible. When using deques that may impose
* insertion restrictions (for example capacity bounds), method
- * offer is generally preferable to method {@link
+ * {@code offer} is generally preferable to method {@link
* Collection#add}, which can fail to insert an element only by
* throwing an exception. This method is equivalent to
* offerLast.
*
* @param o the element to add
- * @return true if it was possible to add the element to
- * this deque, else false
- * @throws NullPointerException if the specified element is null
+ * @return {@code true} if it was possible to add the element to
+ * this deque, else {@code false}
+ * @throws NullPointerException if the specified element is {@code null}
*/
boolean offer(E o, long timeout, TimeUnit unit)
throws InterruptedException;
@@ -226,10 +226,10 @@ public interface BlockingDeque extend
* present on this deque. This method is equivalent to
* pollFirst.
* @param timeout how long to wait before giving up, in units of
- * unit
- * @param unit a TimeUnit determining how to interpret the
- * timeout parameter
- * @return the head of this deque, or null if the
+ * {@code unit}
+ * @param unit a {@code TimeUnit} determining how to interpret the
+ * {@code timeout} parameter
+ * @return the head of this deque, or {@code null} if the
* specified waiting time elapses before an element is present
* @throws InterruptedException if interrupted while waiting
*/