--- 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:

* * * - * - * + * + * * * * @@ -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 */
BlockingQueue Method Equivalent BlockingDeque Method {@code BlockingQueue} Method Equivalent {@code BlockingDeque} Method