From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 3 Nov 2025 05:08:47 +0000 (+0100)
Subject: [3.14] gh-140693: Improve `argparse` documentation about controlling color (GH-140737... 
X-Git-Tag: v3.14.1~250
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fa9bb9a09273c7fba8023b24069f570797de01b4;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-140693: Improve `argparse` documentation about controlling color (GH-140737) (#140932)

gh-140693: Improve `argparse` documentation about controlling color (GH-140737)
(cherry picked from commit 31de83d5e2e17f4e9a37e08b384bab916e1da7c1)

Co-authored-by: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index a7603ac27263..0ee921e15260 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -639,6 +639,11 @@ by setting ``color`` to ``False``::
    ...                     help='an integer for the accumulator')
    >>> parser.parse_args(['--help'])
 
+Note that when ``color=True``, colored output depends on both environment
+variables and terminal capabilities.  However, if ``color=False``, colored
+output is always disabled, even if environment variables like ``FORCE_COLOR``
+are set.
+
 .. versionadded:: 3.14