Skip to content

Commit a79dd88

Browse files
gh-77607: Improve accuracy of os.path.join docs (GH-101406)
This is a follow-up to GH-100811. One of the changes in that PR isn't accurate in that `os.path.join('', '')` will not end in a separator. This reverts that change to the previous wording that used "only", but explicitly calls out the case where the last part ends in a separator, which is what caused confusin in GH-77607 and motivated the change in GH-100811. (cherry picked from commit 909a674) Co-authored-by: Shantanu <[email protected]>
1 parent 6a94f4c commit a79dd88

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

Doc/library/os.path.rst

+5-5
Original file line numberDiff line numberDiff line change
@@ -299,11 +299,11 @@ the :mod:`glob` module.)
299299

300300
Join one or more path segments intelligently. The return value is the
301301
concatenation of *path* and all members of *\*paths*, with exactly one
302-
directory separator following each non-empty part except the last. That is,
303-
if the last part is empty, the result will end in a separator. If
304-
a segment is an absolute path (which on Windows requires both a drive and a
305-
root), then all previous segments are ignored and joining continues from the
306-
absolute path segment.
302+
directory separator following each non-empty part, except the last. That is,
303+
the result will only end in a separator if the last part is either empty or
304+
ends in a separator. If a segment is an absolute path (which on Windows
305+
requires both a drive and a root), then all previous segments are ignored and
306+
joining continues from the absolute path segment.
307307

308308
On Windows, the drive is not reset when a rooted path segment (e.g.,
309309
``r'\foo'``) is encountered. If a segment is on a different drive or is an

0 commit comments

Comments
 (0)