pythonGH-99334: Explain that PurePath.is_relative_to() is purely lexical. (python#114031)

barneygale · barneygale · commit 87b8ccc6f08f · 2024-01-23T01:08:01.000Z
(cherry picked from commit 3a61d24)
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
@@ -510,6 +510,13 @@ Pure paths provide the following methods and properties:
 
    If multiple arguments are supplied, they are joined together.
 
+   This method is string-based; it neither accesses the filesystem nor treats
+   "``..``" segments specially. The following code is equivalent:
+
+      >>> u = PurePath('/usr')
+      >>> u == p or u in p.parents
+      False
+
    .. versionadded:: 3.9
 
 
