Updated documentation regarding buffer size hints.
Better treatment of stream buckets at end of stream.
Updated changelog, readme.
Merge branch 'release/0.3.1'