update docs for exists()

python · barneygale · May 3, 2023 · Nov 20, 2021 · Nov 20, 2021 · Nov 20, 2021
commit 70db4c0ff5a5dde54d900c669cc55b529c0d7fae
@@ -755,9 +755,12 @@ call fails (for example because the path doesn't exist).
    .. versionchanged:: 3.10
       The *follow_symlinks* parameter was added.
 
-.. method:: Path.exists()
+.. method:: Path.exists(follow_symlinks=True)
 
-   Whether the path points to an existing file or directory::
+   Return ``True`` if the path points to an existing file or directory.
+
+   This method normally follows symlinks; to check if a symlink exists, add
+   the argument ``follow_symlinks=False``.
 
       >>> Path('.').exists()
       True
@@ -768,10 +771,8 @@ call fails (for example because the path doesn't exist).
       >>> Path('nonexistentfile').exists()
       False
 
-   .. note::
-      If the path points to a symlink, :meth:`exists` returns whether the
-      symlink *points to* an existing file or directory.
-
+   .. versionchanged:: 3.11
+      The *follow_symlinks* parameter was added.
 
 .. method:: Path.expanduser()