Elaborate a bit in the Reader docs regarding stream position.

Had a conversation with @cmr in IRC about some places that these
docs were confusing. The functions that advance the stream now say so.

In addition, I think that calling out the similarities to familliar C
functions should help people coming from other languages.
Add a few 'function's.

This is now 100% consistent. Whoops!
auto merge of #6621 : steveklabnik/rust/expand_reader_docs, r=thestinger

Had a conversation with @cmr in IRC about some places that these
docs were confusing. The functions that advance the stream now say so.

In addition, I think that calling out the similarities to familliar C
functions should help people coming from other languages.