Expand documentation for the multistream API.

This patch also includes some small edits/additions to the main API
 documentation.
2 files changed