summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGregory P. Smith <greg@krypto.org>2022-05-10 19:31:41 (GMT)
committerGitHub <noreply@github.com>2022-05-10 19:31:41 (GMT)
commit07b34926d3090e50f9ecaa213c564f98fc9a5a93 (patch)
tree6db7d8984be1be91fc41af5579e9093b47fb17b3 /Doc
parentdde8a1668e0a6ad09634d0c701742c91da616497 (diff)
downloadcpython-07b34926d3090e50f9ecaa213c564f98fc9a5a93.zip
cpython-07b34926d3090e50f9ecaa213c564f98fc9a5a93.tar.gz
cpython-07b34926d3090e50f9ecaa213c564f98fc9a5a93.tar.bz2
gh-84131: Remove the deprecated pathlib.Path.link_to method. (#92505)
Co-authored-by: Barney Gale <barney.gale@gmail.com>
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/pathlib.rst19
-rw-r--r--Doc/whatsnew/3.8.rst3
2 files changed, 3 insertions, 19 deletions
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 01e9cfb..535b5ab 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1162,25 +1162,6 @@ call fails (for example because the path doesn't exist).
.. versionadded:: 3.10
-.. method:: Path.link_to(target)
-
- Make *target* a hard link to this path.
-
- .. warning::
-
- This function does not make this path a hard link to *target*, despite
- the implication of the function and argument names. The argument order
- (target, link) is the reverse of :func:`Path.symlink_to` and
- :func:`Path.hardlink_to`, but matches that of :func:`os.link`.
-
- .. versionadded:: 3.8
-
- .. deprecated:: 3.10
-
- This method is deprecated in favor of :meth:`Path.hardlink_to`, as the
- argument order of :meth:`Path.link_to` does not match that of
- :meth:`Path.symlink_to`.
-
.. method:: Path.touch(mode=0o666, exist_ok=True)
diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index 7c293a5..6b88cf6 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -1087,6 +1087,9 @@ contain characters unrepresentable at the OS level.
Added :meth:`pathlib.Path.link_to()` which creates a hard link pointing
to a path.
(Contributed by Joannah Nanjekye in :issue:`26978`)
+Note that ``link_to`` was deprecated in 3.10 and removed in 3.12 in
+favor of a ``hardlink_to`` method added in 3.10 which matches the
+semantics of the existing ``symlink_to`` method.
pickle