diff -r ff1e38119202 Doc/library/os.path.rst --- a/Doc/library/os.path.rst Thu Apr 17 16:23:01 2014 -0400 +++ b/Doc/library/os.path.rst Thu Apr 17 18:30:57 2014 -0400 @@ -208,15 +208,16 @@ .. function:: join(path1[, path2[, ...]]) - Join one or more path components intelligently. If any component is an absolute - path, all previous components (on Windows, including the previous drive letter, - if there was one) are thrown away, and joining continues. The return value is - the concatenation of *path1*, and optionally *path2*, etc., with exactly one - directory separator (``os.sep``) following each non-empty part except the last. - (This means that an empty last part will result in a path that ends with a - separator.) Note that on Windows, since there is a current directory for - each drive, ``os.path.join("c:", "foo")`` represents a path relative to the - current directory on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\foo`. + Join one or more path components intelligently. If a component has an absolute + path or contains a drive letter, previous paths are thrown away. If a component + has a drive letter, the drive letter will be reset. Joining then continues. The + return value is the concatenation of *path1*, and optionally *path2*, etc., with + exactly one directory separator (``os.sep``) following each non-empty part + except the last. (This means that an empty last part will result in a path that + ends with a separator.) Note that on Windows, since there is a current + directory for each drive, ``os.path.join("c:", "foo")`` represents a path + relative to the current directory on drive :file:`C:` (:file:`c:foo`), not + :file:`c:\\foo`. .. function:: normcase(path)