https://github.com/python/cpython/commit/aa17c393397fe582f22d3c449b2dff84ba881537
commit: aa17c393397fe582f22d3c449b2dff84ba881537
branch: 3.14
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: sobolevn <m...@sobolevn.me>
date: 2025-07-21T18:07:56Z
summary:
[3.14] gh-136437: Document some `os.path` functions as requiring pos-only
(GH-136812) (#136944)
gh-136437: Document some `os.path` functions as requiring pos-only (GH-136812)
(cherry picked from commit b5428bb0e786f5b67c6077472c0068cadd0b5ea9)
Co-authored-by: sobolevn <m...@sobolevn.me>
files:
M Doc/library/os.path.rst
diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 3f2574e55699bf..734b6ef5d5d57c 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -64,7 +64,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
-.. function:: basename(path)
+.. function:: basename(path, /)
Return the base name of pathname *path*. This is the second element of the
pair returned by passing *path* to the function :func:`split`. Note that
@@ -237,7 +237,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
-.. function:: isabs(path)
+.. function:: isabs(path, /)
Return ``True`` if *path* is an absolute pathname. On Unix, that means it
begins with a slash, on Windows that it begins with two (back)slashes, or a
@@ -261,7 +261,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
-.. function:: isdir(path)
+.. function:: isdir(path, /)
Return ``True`` if *path* is an :func:`existing <exists>` directory. This
follows symbolic links, so both :func:`islink` and :func:`isdir` can be true
@@ -372,7 +372,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object` for *path* and *paths*.
-.. function:: normcase(path)
+.. function:: normcase(path, /)
Normalize the case of a pathname. On Windows, convert all characters in the
pathname to lowercase, and also convert forward slashes to backward slashes.
@@ -509,7 +509,7 @@ the :mod:`glob` module.)
Added Windows support.
-.. function:: split(path)
+.. function:: split(path, /)
Split the pathname *path* into a pair, ``(head, tail)`` where *tail* is the
last pathname component and *head* is everything leading up to that. The
@@ -525,7 +525,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
-.. function:: splitdrive(path)
+.. function:: splitdrive(path, /)
Split the pathname *path* into a pair ``(drive, tail)`` where *drive* is
either
a mount point or the empty string. On systems which do not use drive
@@ -550,7 +550,7 @@ the :mod:`glob` module.)
Accepts a :term:`path-like object`.
-.. function:: splitroot(path)
+.. function:: splitroot(path, /)
Split the pathname *path* into a 3-item tuple ``(drive, root, tail)`` where
*drive* is a device name or mount point, *root* is a string of separators
@@ -583,7 +583,7 @@ the :mod:`glob` module.)
.. versionadded:: 3.12
-.. function:: splitext(path)
+.. function:: splitext(path, /)
Split the pathname *path* into a pair ``(root, ext)`` such that ``root +
ext ==
path``, and the extension, *ext*, is empty or begins with a period and
contains at
_______________________________________________
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
