--- jsr166/src/jsr166x/BlockingDeque.java 2011/03/15 19:47:02 1.4 +++ jsr166/src/jsr166x/BlockingDeque.java 2012/12/29 23:55:19 1.5 @@ -89,8 +89,8 @@ public interface BlockingDeque extend * Adds the specified element as the first element of this deque, * 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 InterruptedException if interrupted while waiting + * @throws NullPointerException if the specified element is null */ void putFirst(E o) throws InterruptedException; @@ -98,8 +98,8 @@ public interface BlockingDeque extend * Adds the specified element as the last element of this deque, * 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 InterruptedException if interrupted while waiting + * @throws NullPointerException if the specified element is null */ void putLast(E o) throws InterruptedException; @@ -107,7 +107,7 @@ public interface BlockingDeque extend * Retrieves and removes the first element of this deque, waiting * if no elements are present on this deque. * @return the head of this deque - * @throws InterruptedException if interrupted while waiting. + * @throws InterruptedException if interrupted while waiting */ E takeFirst() throws InterruptedException; @@ -115,7 +115,7 @@ public interface BlockingDeque extend * Retrieves and removes the last element of this deque, waiting * if no elements are present on this deque. * @return the head of this deque - * @throws InterruptedException if interrupted while waiting. + * @throws InterruptedException if interrupted while waiting */ E takeLast() throws InterruptedException; @@ -129,9 +129,9 @@ public interface BlockingDeque extend * @param unit a TimeUnit determining how to interpret the * timeout parameter * @return true if successful, or 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. + * the specified waiting time elapses before space is available + * @throws InterruptedException if interrupted while waiting + * @throws NullPointerException if the specified element is null */ boolean offerFirst(E o, long timeout, TimeUnit unit) throws InterruptedException; @@ -146,9 +146,9 @@ public interface BlockingDeque extend * @param unit a TimeUnit determining how to interpret the * timeout parameter * @return true if successful, or 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. + * the specified waiting time elapses before space is available + * @throws InterruptedException if interrupted while waiting + * @throws NullPointerException if the specified element is null */ boolean offerLast(E o, long timeout, TimeUnit unit) throws InterruptedException; @@ -163,8 +163,8 @@ public interface BlockingDeque extend * @param unit a TimeUnit determining how to interpret the * timeout parameter * @return the head of this deque, or null if the - * specified waiting time elapses before an element is present. - * @throws InterruptedException if interrupted while waiting. + * specified waiting time elapses before an element is present + * @throws InterruptedException if interrupted while waiting */ E pollFirst(long timeout, TimeUnit unit) throws InterruptedException; @@ -178,8 +178,8 @@ public interface BlockingDeque extend * @param unit a TimeUnit determining how to interpret the * timeout parameter * @return the head of this deque, or null if the - * specified waiting time elapses before an element is present. - * @throws InterruptedException if interrupted while waiting. + * specified waiting time elapses before an element is present + * @throws InterruptedException if interrupted while waiting */ E pollLast(long timeout, TimeUnit unit) throws InterruptedException; @@ -189,8 +189,8 @@ public interface BlockingDeque extend * waiting if necessary for space to become available. This * 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 InterruptedException if interrupted while waiting + * @throws NullPointerException if the specified element is null */ void put(E o) throws InterruptedException; @@ -201,9 +201,9 @@ public interface BlockingDeque extend * 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 + * offerLast. * - * @param o the element to add. + * @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 @@ -214,9 +214,9 @@ public interface BlockingDeque extend /** * Retrieves and removes the first element of this deque, waiting * if no elements are present on this deque. - * This method is equivalent to takeFirst + * This method is equivalent to takeFirst. * @return the head of this deque - * @throws InterruptedException if interrupted while waiting. + * @throws InterruptedException if interrupted while waiting */ E take() throws InterruptedException; @@ -224,14 +224,14 @@ public interface BlockingDeque extend * Retrieves and removes the first element of this deque, waiting * if necessary up to the specified wait time if no elements are * present on this deque. This method is equivalent to - * pollFirst + * 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 - * specified waiting time elapses before an element is present. - * @throws InterruptedException if interrupted while waiting. + * specified waiting time elapses before an element is present + * @throws InterruptedException if interrupted while waiting */ E poll(long timeout, TimeUnit unit) throws InterruptedException;