From: Alex Waygood <Alex.Waygood@Gmail.com>
Date: Thu, 27 Apr 2023 14:56:55 +0000 (-0600)
Subject: [3.11] gh-51574: Document behaviour of `mkdtemp` on 3.11 and lower (#103844)
X-Git-Tag: v3.11.4~153
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d20758c4ef74aa85219b85e18259e86575e52966;p=thirdparty%2FPython%2Fcpython.git

[3.11] gh-51574: Document behaviour of `mkdtemp` on 3.11 and lower (#103844)
---

diff --git a/Doc/library/tempfile.rst b/Doc/library/tempfile.rst
index b7e604c1b70a..c17ead1510e7 100644
--- a/Doc/library/tempfile.rst
+++ b/Doc/library/tempfile.rst
@@ -226,7 +226,10 @@ The module defines the following user-callable items:
    The *prefix*, *suffix*, and *dir* arguments are the same as for
    :func:`mkstemp`.
 
-   :func:`mkdtemp` returns the absolute pathname of the new directory.
+   :func:`mkdtemp` returns the absolute pathname of the new directory if *dir*
+   is ``None`` or is an absolute path. If *dir* is a relative path,
+   :func:`mkdtemp` returns a relative path on Python 3.11 and lower. However,
+   on 3.12 it will return an absolute path in all situations.
 
    .. audit-event:: tempfile.mkdtemp fullpath tempfile.mkdtemp