From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 2 Aug 2019 23:04:53 +0000 (-0700)
Subject: bpo-30974: Change os.path.samefile docstring to match docs (GH-7337)
X-Git-Tag: v3.8.0b4~138
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6b833901fe9053937c289c6371bb731c9aceb58e;p=python

bpo-30974: Change os.path.samefile docstring to match docs (GH-7337)

(cherry picked from commit 8e568ef266a2805f9a6042003723d9c050830461)

Co-authored-by: Timo Furrer <tuxtimo@gmail.com>
---

diff --git a/Lib/genericpath.py b/Lib/genericpath.py
index 5dd703d736..db11f67d54 100644
--- a/Lib/genericpath.py
+++ b/Lib/genericpath.py
@@ -92,7 +92,11 @@ def samestat(s1, s2):
 
 # Are two filenames really pointing to the same file?
 def samefile(f1, f2):
-    """Test whether two pathnames reference the same actual file"""
+    """Test whether two pathnames reference the same actual file or directory
+
+    This is determined by the device number and i-node number and
+    raises an exception if an os.stat() call on either pathname fails.
+    """
     s1 = os.stat(f1)
     s2 = os.stat(f2)
     return samestat(s1, s2)