https://github.com/python/cpython/commit/d13d5fdf610a294a6c3dc125e0856fb7fdd41e49
commit: d13d5fdf610a294a6c3dc125e0856fb7fdd41e49
branch: main
author: Kokona <125976684+985025...@users.noreply.github.com>
committer: serhiy-storchaka <storch...@gmail.com>
date: 2025-05-10T10:06:19+03:00
summary:
gh-132971: Update shutil.which() docs (GH-133067)
files:
M Doc/library/shutil.rst
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 2cbf95bcf535e4..c78dfe1aafa0ed 100644
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -454,6 +454,10 @@ Directory and files operations
:envvar:`PATH` environment variable is read from :data:`os.environ`,
falling back to :data:`os.defpath` if it is not set.
+ If *cmd* contains a directory component, :func:`!which` only checks the
+ specified path directly and does not search the directories listed in
+ *path* or in the system's :envvar:`PATH` environment variable.
+
On Windows, the current directory is prepended to the *path* if *mode* does
not include ``os.X_OK``. When the *mode* does include ``os.X_OK``, the
Windows API ``NeedCurrentDirectoryForExePathW`` will be consulted to
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
