Document Deque trait and bitv.

[treeman]

Examples for Deque, Bitv and BitvSet. Normalize documentation style and some source code reorganization.

[errordeveloper]

Why not "bit vectors"?

[treeman]

That's interesting. I moved some functions to group them more logically, but it appears github renders them as if I rewrote them. I'll see if I can split up the commits.

[errordeveloper]

same as above. I'm also not quite sure whether #[inline] should live above comments, probably not.

[errordeveloper]

I know it's a bit laborious, but would makes it easier to review and blame or bisect 👍

[treeman]

Yes I totally understand, no worries.

[huonw]

// mark all multiples of i as non-prime (any multiples below i * i 
// will have been marked as non-prime previously)
for j in iter::range(i * i, max_prime, i) { bv.set(j, false) }

[huonw]

What is false divided by 0? :P

Maybe just false (with backticks) is enough?

[huonw]

FWIW, you can efficiently implement a stack with just Vec (via .push and .pop), no need for Deque or RingBuf. Maybe this could be moved to after the queue example?

[huonw]

This example and those below don't have the closing

```

[huonw]

Awesome docs! Thanks so much for this.

[treeman]

I think I've got the commits sorted out and I've simplified most examples.

Thanks for the good eyes and tips!