doc: note 'resize' event conditions on Windows

Dean-Coakley · MylesBorins · commit 9599faae187a · 2017-09-05T12:49:52.000-04:00
PR-URL: #13576 Fixes: #13197 Reviewed-By: Tobias Nießen <tniessen@tnie.de> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com> Reviewed-By: Gibson Fahnestock <gibfahn@gmail.com> Reviewed-By: Refael Ackermann <refack@gmail.com>
diff --git a/doc/api/tty.md b/doc/api/tty.md
@@ -88,6 +88,15 @@ process.stdout.on('resize', () => {
 });
 ```
 
+*Note*: On Windows resize events will be emitted only if stdin is unpaused
+(by a call to `resume()` or by adding a data listener) and in raw mode. It can
+also be triggered if a terminal control sequence that moves the cursor is
+written to the screen. Also, the resize event will only be signaled if the
+console screen buffer height was also changed. For example shrinking the
+console window height will not cause the resize event to be emitted. Increasing
+the console window height will only be registered when the new console window
+height is greater than the current console buffer size.
+
 ### writeStream.columns
 <!-- YAML
 added: v0.7.7
