From 31de83d5e2e17f4e9a37e08b384bab916e1da7c1 Mon Sep 17 00:00:00 2001
From: Krishna Chaitanya <141550576+XChaitanyaX@users.noreply.github.com>
Date: Mon, 3 Nov 2025 03:28:16 +0530
Subject: [PATCH] gh-140693: Improve `argparse` documentation about controlling
 color (#140737)

---
 Doc/library/argparse.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 418f514995df..9655db4f301a 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -638,6 +638,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
 
 
-- 
2.47.3