From 6da59fec6cd0c0afe5edeb7d91daf929ea4a3601 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 9 Jun 2017 14:40:53 +0100
Subject: [PATCH 1/9] doc: note 'resize' event unreliability on Windows

---
 doc/api/tty.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 8f250e45d655f9..2b4c96f7430573 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -82,12 +82,15 @@ or `writeStream.rows` properties have changed. No arguments are passed to the
 listener callback when called.
 
 ```js
+process.stdin.setRawMode(true);
 process.stdout.on('resize', () => {
   console.log('screen size has changed!');
   console.log(`${process.stdout.columns}x${process.stdout.rows}`);
 });
 ```
 
+*Note:* Unrealiable event handler execution on all Windows platforms.
+
 ### writeStream.columns
 <!-- YAML
 added: v0.7.7

From a45bd1d751cb45fed2f08842a3d52e66f03e0925 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 9 Jun 2017 17:30:55 +0100
Subject: [PATCH 2/9] doc: correct 'resize' event note

---
 doc/api/tty.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 2b4c96f7430573..d8affebdff215b 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -82,7 +82,6 @@ or `writeStream.rows` properties have changed. No arguments are passed to the
 listener callback when called.
 
 ```js
-process.stdin.setRawMode(true);
 process.stdout.on('resize', () => {
   console.log('screen size has changed!');
   console.log(`${process.stdout.columns}x${process.stdout.rows}`);

From 84db75d4dd6fa28f6f200937d4e748c2e9be479a Mon Sep 17 00:00:00 2001
From: Dean <dean.s.coakley@gmail.com>
Date: Thu, 15 Jun 2017 03:13:37 +0100
Subject: [PATCH 3/9] doc: add more detail on note

---
 doc/api/tty.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index d8affebdff215b..49fef70a0c3f43 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -88,7 +88,7 @@ process.stdout.on('resize', () => {
 });
 ```
 
-*Note:* Unrealiable event handler execution on all Windows platforms.
+*Note:* Unrealiable event handler execution on all Windows platforms. The Event handler is only executed for changes in the width of the window and the console must be in raw mode.
 
 ### writeStream.columns
 <!-- YAML

From 63fa37549efbea699ea17dbf1e37f49db8986dd0 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Thu, 15 Jun 2017 11:54:40 +0100
Subject: [PATCH 4/9] doc: correct char limit

---
 doc/api/tty.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 49fef70a0c3f43..8be6b6bd6330a8 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -88,7 +88,9 @@ process.stdout.on('resize', () => {
 });
 ```
 
-*Note:* Unrealiable event handler execution on all Windows platforms. The Event handler is only executed for changes in the width of the window and the console must be in raw mode.
+*Note:* Terminal window resize events are unreliable on Windows. The event 
+handler is only executed for changes in the width of the window and the 
+console must be in raw mode.
 
 ### writeStream.columns
 <!-- YAML

From 86dfd244dcc48970c4c7d789803323f6c1dd5ac2 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 7 Jul 2017 04:15:33 +0100
Subject: [PATCH 5/9] doc: add more detail on note

---
 doc/api/tty.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 8be6b6bd6330a8..f1ab46cb700019 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -88,9 +88,16 @@ process.stdout.on('resize', () => {
 });
 ```
 
-*Note:* Terminal window resize events are unreliable on Windows. The event 
-handler is only executed for changes in the width of the window and the 
-console must be in raw mode.
+*Note:* On Windows resize events will be emitted only if stdin is unpaused 
+(by a call to resume() or by adding data listener) and in raw mode. It can be 
+also triggered if terminal control sequence that moves the cursor is written to 
+the screen.
+
+*Note:* On Windows when changing console height the resize event will be 
+signaled only if 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 new 
+console window height is greater than current console buffer size.
 
 ### writeStream.columns
 <!-- YAML

From 192a56fb7c8829a6ec09b4ade537c3c3039613e5 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 7 Jul 2017 12:48:05 +0100
Subject: [PATCH 6/9] doc: fix details on note

---
 doc/api/tty.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index f1ab46cb700019..429b36ce434741 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -89,15 +89,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 data listener) and in raw mode. It can be 
-also triggered if terminal control sequence that moves the cursor is written to 
-the screen.
+(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.
 
 *Note:* On Windows when changing console height the resize event will be 
-signaled only if console screen buffer height was also changed. For example 
+signaled only 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 new 
-console window height is greater than current console buffer size.
+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

From 784055f13d7396576dca1f9693242e22f680714c Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 7 Jul 2017 12:52:53 +0100
Subject: [PATCH 7/9] doc: fix err on resume note

---
 doc/api/tty.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 429b36ce434741..1179f8cb65ca56 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -89,7 +89,7 @@ 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 
+(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.
 

From 05ce78a392329a52f7fb11ad353141ca2e145849 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Fri, 7 Jul 2017 15:27:02 +0100
Subject: [PATCH 8/9] doc: remove backslash

---
 doc/api/tty.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 1179f8cb65ca56..00cd3be203275b 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -89,7 +89,7 @@ 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 
+(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.
 

From 5944bf02129215347ff603e93809e1eaaea6f896 Mon Sep 17 00:00:00 2001
From: Dean Coakley <dean.s.coakley@gmail.com>
Date: Sun, 9 Jul 2017 20:27:45 +0100
Subject: [PATCH 9/9] doc: merge note paragraphs

---
 doc/api/tty.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 00cd3be203275b..d72d687c026425 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -88,16 +88,14 @@ process.stdout.on('resize', () => {
 });
 ```
 
-*Note:* On Windows resize events will be emitted only if stdin is unpaused 
+*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.
-
-*Note:* On Windows when changing console height the resize event will be 
-signaled only 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.
+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