From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 26 Apr 2021 19:46:14 +0000 (-0700)
Subject: bpo-41661: Document os.path.relpath() exception on Windows with different drives... 
X-Git-Tag: v3.8.10~23
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b570feaa9c6039b9d89cdf854a5fb388872eb38e;p=thirdparty%2FPython%2Fcpython.git

bpo-41661: Document os.path.relpath() exception on Windows with different drives (GH-25346) (#25367)

(cherry picked from commit 67c0b3d89c4da9750fdb43fc66d3924681b22d2e)

Co-authored-by: Zackery Spytz <zspytz@gmail.com>
---

diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
index 251df4d516eb..d2fe49435245 100644
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -366,7 +366,8 @@ the :mod:`glob` module.)
    Return a relative filepath to *path* either from the current directory or
    from an optional *start* directory.  This is a path computation:  the
    filesystem is not accessed to confirm the existence or nature of *path* or
-   *start*.
+   *start*.  On Windows, :exc:`ValueError` is raised when *path* and *start*
+   are on different drives.
 
    *start* defaults to :attr:`os.curdir`.