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, 3 insertions, 0 deletions

diff --git a/lib/stream.js b/lib/stream.js
index 1ad08ec14b..2869e8248f 100644
--- a/lib/stream.js
+++ b/lib/stream.js
@@ -157,4 +157,7 @@ Stream.prototype.pipe = function(dest, options) {
   dest.on('close', cleanup);
 
   dest.emit('pipe', source);
+
+  // Allow for unix-like usage: A.pipe(B).pipe(C)
+  return dest;
 };