Close #1303 Stream.pipe returns the destination

Squashed:

* Simple change to make Stream.pipe(destination) return the destination Stream
* Test: ensure Stream.pipe(destination) returns the destination Stream
* updated Stream.pipe() documentation to reflect that it now returns the
  destination stream

1 files changed, 2 insertions, 0 deletions

diff --git a/doc/api/streams.markdown b/doc/api/streams.markdown
index 2bc05f3ec9b..01a841a1c31 100644
--- a/doc/api/streams.markdown
+++ b/doc/api/streams.markdown
@@ -78,6 +78,8 @@ Connects this read stream to `destination` WriteStream. Incoming
 data on this stream gets written to `destination`. The destination and source
 streams are kept in sync by pausing and resuming as necessary.
 
+This function returns the `destination` stream.
+
 Emulating the Unix `cat` command:
 
     process.stdin.resume();