[Python-checkins] cpython (merge 3.3 -> default): #18389: Clarify that relpath does not access the file system.

[r.david.murray]

http://hg.python.org/cpython/rev/7de05609e390
changeset:   84600:7de05609e390
parent:      84598:d292635314c9
parent:      84599:70837970c5d8
user:        R David Murray <rdmurray at bitdance.com>
date:        Fri Jul 12 17:43:53 2013 -0400
summary:
  #18389: Clarify that relpath does not access the file system.

Initial patch by Madison May.

files:
  Doc/library/os.path.rst |  6 ++++--
  1 files changed, 4 insertions(+), 2 deletions(-)


diff --git a/Doc/library/os.path.rst b/Doc/library/os.path.rst
--- a/Doc/library/os.path.rst
+++ b/Doc/library/os.path.rst
@@ -233,8 +233,10 @@
 
 .. function:: relpath(path, start=None)
 
-   Return a relative filepath to *path* either from the current directory or from
-   an optional *start* point.
+   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* defaults to :attr:`os.curdir`.
 

-- 
Repository URL: http://hg.python.org/cpython