gh-101754: Document that Windows converts keys in os.environ to upp…

…ercase (GH-101840) (cherry picked from commit 4e7c0cb) Co-authored-by: Owain Davies <[email protected]>
python · Mar 3, 2023 · 3d88b4e · 3d88b4e
1 parent 47cc6fa
commit 3d88b4e
Showing 1 changed file with 5 additions and 0 deletions.
diff --git 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