joyent/node — pull request #2989 by domenic (2012-03-22 16:09:23+00:00)
Title: Noting that `stream.pause` is advisory.

This should help save future users much confusion.

See [some discussion on the mailing list](https://groups.google.com/forum/?fromgroups#!topic/nodejs/yv6Dl-O-wYk) and, as a bonus, [the massive confusion I managed to cause for myself](http://stackoverflow.com/questions/9812993/nodejs-stream-pausing-resuming-does-not-work-with-xmlhttprequest-but-works-with).

I'll go sign that CLA thing.