Document Deque trait and bitv.

Examples for `Deque`, `Bitv` and `BitvSet`. Normalize documentation style and some source code reorganization.
Looks like this has been refactored and moved down in this diff... not quite clear, there is certainly an need to split these sort of changes into a separate commit that describes what's being done.