summaryrefslogtreecommitdiffstats
path: root/Lib
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2012-07-21 18:33:56 (GMT)
committerR David Murray <rdmurray@bitdance.com>2012-07-21 18:33:56 (GMT)
commite3de175a5e280a01fda003a825bab7bdfedf445b (patch)
tree3ab278f524a0e4986fa1e5758635ec2fa5628264 /Lib
parentef391ac982400f3917037bfaa3a590dc3d61eeb4 (diff)
downloadcpython-e3de175a5e280a01fda003a825bab7bdfedf445b.zip
cpython-e3de175a5e280a01fda003a825bab7bdfedf445b.tar.gz
cpython-e3de175a5e280a01fda003a825bab7bdfedf445b.tar.bz2
#15342: Add clarifying sentence to posixpath.join docstring.
This sentence appears as a clarifying note in the HTML docs, and seems worth having in the docstring since it covers a very common use case that isn't otherwise obvious. Thanks to Yongzhi Pan for the suggestion.
Diffstat (limited to 'Lib')
-rw-r--r--Lib/posixpath.py3
1 files changed, 2 insertions, 1 deletions
diff --git a/Lib/posixpath.py b/Lib/posixpath.py
index 7a4daa8b..2e3625b 100644
--- a/Lib/posixpath.py
+++ b/Lib/posixpath.py
@@ -71,7 +71,8 @@ def isabs(s):
def join(a, *p):
"""Join two or more pathname components, inserting '/' as needed.
If any component is an absolute path, all previous path components
- will be discarded."""
+ will be discarded. An empty last part will result in a path that
+ ends with a separator."""
sep = _get_sep(a)
path = a
try: