Skip to content

Commit 909a674

Browse files
authored
gh-77607: Improve accuracy of os.path.join docs (#101406)
This is a follow-up to #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 #77607 and motivated the change in #100811.
1 parent ef09bf6 commit 909a674

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
@@ -308,11 +308,11 @@ the :mod:`glob` module.)
308308

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

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

0 commit comments

Comments
 (0)