| 
						 | 
						- # PauseStream
 - 
 - This is a `Stream` that will strictly buffer when paused.
 - Connect it to anything you need buffered.
 - 
 - ``` js
 -   var ps = require('pause-stream')();
 - 
 -   badlyBehavedStream.pipe(ps.pause())
 - 
 -   aLittleLater(function (err, data) {
 -     ps.pipe(createAnotherStream(data))
 -     ps.resume()
 -   })
 - ```
 - 
 - `PauseStream` will buffer whenever paused.
 - it will buffer when yau have called `pause` manually.
 - but also when it's downstream `dest.write()===false`.
 - it will attempt to drain the buffer when you call resume
 - or the downstream emits `'drain'`
 - 
 - `PauseStream` is tested using [stream-spec](https://github.com/dominictarr/stream-spec)
 - and [stream-tester](https://github.com/dominictarr/stream-tester)
 - 
 - This is now the default case of 
 - [through](https://github.com/dominictarr/through)
 - 
 - https://github.com/dominictarr/pause-stream/commit/4a6fe3dc2c11091b1efbfde912e0473719ed9cc0
 
 
  |