Issue 873: doc update for global output streams

[jmeyre]

This PR addresses issue #873

Hi, this is my first contribution to the project so I took a simple documentation issue. Since I'm new to the project, please let me know if there are any problems with the example or if additional clarity is needed for the wording, thanks.