From: Stanley <46876382+slateny@users.noreply.github.com>
Date: Mon, 24 Apr 2023 13:52:31 +0000 (-0700)
Subject: gh-44123: Add note on relative path for os.exec* (GH-93826)
X-Git-Tag: v3.12.0b1~466
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=59c522f9650c22dc986debce483b83a4ffc6dc0d;p=thirdparty%2FPython%2Fcpython.git

gh-44123: Add note on relative path for os.exec* (GH-93826)

Co-authored-by: Steve Dower <steve.dower@python.org>
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 7bb501c59468..50e951c631fa 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -3919,7 +3919,8 @@ to be ignored.
    the :envvar:`PATH` variable. The other variants, :func:`execl`, :func:`execle`,
    :func:`execv`, and :func:`execve`, will not use the :envvar:`PATH` variable to
    locate the executable; *path* must contain an appropriate absolute or relative
-   path.
+   path. Relative paths must include at least one slash, even on Windows, as
+   plain names will not be resolved.
 
    For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` (note
    that these all end in "e"), the *env* parameter must be a mapping which is