empty!() for CircularDeque, add it to docs, add some other missing things to docs

[KadeG]

No description provided.

[codecov]

Codecov Report

Merging #317 into master will decrease coverage by 29.18%.
The diff coverage is 50%.

@@             Coverage Diff             @@
##           master     #317       +/-   ##
===========================================
- Coverage   96.36%   67.18%   -29.19%     
===========================================
  Files          31       31               
  Lines        2284     3279      +995     
===========================================
+ Hits         2201     2203        +2     
- Misses         83     1076      +993

Impacted Files	Coverage Δ
src/circular_buffer.jl	66% <50%> (-34%)	⬇️
src/delegate.jl	50% <0%> (-50%)	⬇️
src/tokens.jl	50% <0%> (-50%)	⬇️
src/dict_support.jl	57.14% <0%> (-42.86%)	⬇️
src/accumulator.jl	58.92% <0%> (-41.08%)	⬇️
src/tokens2.jl	60.93% <0%> (-39.07%)	⬇️
src/container_loops.jl	60.27% <0%> (-38.61%)	⬇️
src/stack.jl	57.14% <0%> (-35.17%)	⬇️
src/queue.jl	59.09% <0%> (-33.77%)	⬇️
src/heaps.jl	66.66% <0%> (-33.34%)	⬇️
... and 22 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7178c60...625bcae. Read the comment docs.

[kmsquire]

Thanks for the contribution! A couple of minor comments below.

[kmsquire]

I think you also need to reset cb.first = 1. Is there a reason you didn't just call empty!(cb.buffer)?

[kmsquire]

Also, could you add a quick test for this?

[KadeG]

Changes make. Test added. Your suggestion is much faster. Thanks for the help!

[kmsquire]

Coverage reduction is a problem in Coverage.jl: JuliaCI/Coverage.jl#132

LGTM! Thanks for the contribution.