From: Filipe Laíns Date: Wed, 1 May 2024 23:13:32 +0000 (+0100) Subject: GH-118174: specify the type for the path argument of shutil.which X-Git-Tag: v3.13.0b1~167 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=97feb4a78bf1ebdec26b685fd509cf57b3333e4a;p=thirdparty%2FPython%2Fcpython.git GH-118174: specify the type for the path argument of shutil.which --- diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 8e5828c789e4..542d28864777 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -449,8 +449,9 @@ Directory and files operations *mode* is a permission mask passed to :func:`os.access`, by default determining if the file exists and executable. - When no *path* is specified, the results of :func:`os.environ` are used, - returning either the "PATH" value or a fallback of :data:`os.defpath`. + *path* is a "``PATH`` string" specifying the lookup directory list. When no + *path* is specified, the results of :func:`os.environ` are used, returning + either the "PATH" value or a fallback of :data:`os.defpath`. 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