The new interface BlockingDeque has many different methods, that come in
many flavors based on the three dimensions:
- blocking/exception behavior (4 variants)
- first/last/unspecified-endian (3 variants)
- insert/remove/examine (3 variants)

So there are up to 36 different methods (some are missing; in fact only 30) a user
needs to keep track of. We need good html tables in the class javadoc
to clarify all of these many methods.

Similarly, BlockingQueue, Deque, and Queue can have minor improvements to their
method tables. The methods in the javadoc should be presented in the same order
as their presentation in the corresponding table.
###@###.### 2005-05-12 22:56:27 GMT