From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 3 Mar 2023 10:58:30 +0000 (-0800)
Subject: gh-101754: Document that Windows converts keys in `os.environ` to uppercase (GH-101840)
X-Git-Tag: v3.10.11~63
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3d88b4e51a08d20c9325491226763a70eff164f8;p=thirdparty%2FPython%2Fcpython.git

gh-101754: Document that Windows converts keys in `os.environ` to uppercase (GH-101840)

(cherry picked from commit 4e7c0cbf59595714848cf9827f6e5b40c3985924)

Co-authored-by: Owain Davies <116417456+OTheDev@users.noreply.github.com>
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index e5fc63afdcf5..1f1e2fd31454 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -188,6 +188,11 @@ process and user.
    ``'surrogateescape'`` error handler. Use :data:`environb` if you would like
    to use a different encoding.
 
+   On Windows, the keys are converted to uppercase. This also applies when
+   getting, setting, or deleting an item. For example,
+   ``environ['monty'] = 'python'`` maps the key ``'MONTY'`` to the value
+   ``'python'``.
+
    .. note::
 
       Calling :func:`putenv` directly does not change :data:`os.environ`, so it's better