fixup: be consistent and use r.src when reading the stream identifier
fixup: document noeof* functions
test decoding of corrupt data
documentation cleanup