added docs +doctests to `BufRead::consume`#782

feefladder wants to merge 2 commits intotokio-rs:mastertokio-rs/bytes:masterfrom

feefladder:consume-docsfeefladder/bytes:consume-docsCopy head branch name to clipboard