These docs need to be completely re-written. Thanks for pointing this out. This API is a bit confusing, since it also supports piping. 

If you're not piping a stream, you must provide either `stream` or `local. However, if you're piping, you don't have to use either, and can pipe the source stream to the destination stream.