Improve streams

Since this is ours and is part of the public library API, it should have at least a rudimentary doc-comment.