doc: Update to reflect new _read() interface
doc: Clarify advisory-ness of stream._read() argument