From 462fcfbb7264efc5bc3e91ebbfc51e4701ad2944 Mon Sep 17 00:00:00 2001
From: Ruben Bridgewater <ruben@bridgewater.de>
Date: Thu, 21 Feb 2019 20:57:52 +0100
Subject: [PATCH 1/5] doc: add examples for tty.getColorDepth() env

This adds some examples what values can be used to enforce a specific
color support in Node.js.
---
 doc/api/tty.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 26761442a50865..4ea1773be3b05b 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -165,6 +165,16 @@ to pass in an object with different settings.
 Use the `NODE_DISABLE_COLORS` environment variable to enforce this function to
 always return 1.
 
+To enforce a specific color support it's possible to set either one of the
+following environment settings.
+This rule does not apply to Windows OS, CI environments and some other rare
+cases.
+
+* 2 colors: `NODE_DISABLE_COLORS = 1`
+* 16 colors: `TERM = 'console'`
+* 256 colors: `TMUX = 1`
+* 16,777,216 colors: `TERM_PROGRAM = 'Hyper'`
+
 ### writeStream.getWindowSize()
 <!-- YAML
 added: v0.7.7

From 6f0d65c9a0527a28d307211c99f105803b21c39e Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Thu, 21 Feb 2019 21:52:37 +0100
Subject: [PATCH 2/5] fixup: add comma

Co-Authored-By: BridgeAR <ruben@bridgewater.de>
---
 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 4ea1773be3b05b..2090aada5522a6 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -167,7 +167,7 @@ always return 1.
 
 To enforce a specific color support it's possible to set either one of the
 following environment settings.
-This rule does not apply to Windows OS, CI environments and some other rare
+This rule does not apply to Windows OS, CI environments, and some other rare
 cases.
 
 * 2 colors: `NODE_DISABLE_COLORS = 1`

From 049c69d8eb3ca9a92b8c40fd0a165b609cb819d0 Mon Sep 17 00:00:00 2001
From: Rich Trott <rtrott@gmail.com>
Date: Thu, 21 Feb 2019 21:52:47 +0100
Subject: [PATCH 3/5] fixup: add comma

Co-Authored-By: BridgeAR <ruben@bridgewater.de>
---
 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 2090aada5522a6..9df0e507048968 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -165,7 +165,7 @@ to pass in an object with different settings.
 Use the `NODE_DISABLE_COLORS` environment variable to enforce this function to
 always return 1.
 
-To enforce a specific color support it's possible to set either one of the
+To enforce a specific color support, it's possible to set either one of the
 following environment settings.
 This rule does not apply to Windows OS, CI environments, and some other rare
 cases.

From 5c8189e04411c390fdca5518c493d488673d910a Mon Sep 17 00:00:00 2001
From: Ruben Bridgewater <ruben@bridgewater.de>
Date: Thu, 21 Feb 2019 22:05:25 +0100
Subject: [PATCH 4/5] fixup: add suggestion

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

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 9df0e507048968..688c3d67de2bea 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -165,8 +165,7 @@ to pass in an object with different settings.
 Use the `NODE_DISABLE_COLORS` environment variable to enforce this function to
 always return 1.
 
-To enforce a specific color support, it's possible to set either one of the
-following environment settings.
+To enforce a specific color support, use one of the below environment settings.
 This rule does not apply to Windows OS, CI environments, and some other rare
 cases.
 

From 6e82571903603aa281217c010ce29bfea12fa58a Mon Sep 17 00:00:00 2001
From: Ruben Bridgewater <ruben@bridgewater.de>
Date: Fri, 22 Feb 2019 11:15:23 +0100
Subject: [PATCH 5/5] fixup: fix comment about disabling support

---
 doc/api/tty.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 688c3d67de2bea..061a26d0c8058c 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -162,12 +162,9 @@ may lie about what terminal is used.
 To enforce a specific behavior without relying on `process.env` it is possible
 to pass in an object with different settings.
 
-Use the `NODE_DISABLE_COLORS` environment variable to enforce this function to
-always return 1.
-
 To enforce a specific color support, use one of the below environment settings.
 This rule does not apply to Windows OS, CI environments, and some other rare
-cases.
+cases. Only disabling color support with `NODE_DISABLE_COLORS` will always work.
 
 * 2 colors: `NODE_DISABLE_COLORS = 1`
 * 16 colors: `TERM = 'console'`