Document behavior of Path.symlink_to() when source already exists

Documentation

The documentation for Path.symlink_to() [1] does not mention what happens when the source already exists, e.g.:

>>> from pathlib import Path
>>> Path("source").symlink_to("target1")
>>> Path("source").symlink_to("target2")
Traceback (most recent call last):
  File "<python-input-2>", line 1, in <module>
    Path("source").symlink_to("target2")
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
  File "/usr/lib/python3.13/pathlib/_local.py", line 789, in symlink_to
    os.symlink(target, self, target_is_directory)
    ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileExistsError: [Errno 17] File exists: 'target2' -> 'source'

(The same applies to os.symlink [2] by the way)

Linked PRs

• gh-132704
• gh-132810

Issue にリンクされている pathlib.Path.symlink_to() のドキュメントから始め、同じ動作について os.symlink() のドキュメントと比較してください。宛先パスがすでに存在する場合に何が起こるかを、ここに示した FileExistsError の例も含めて、両方のエントリで説明できれば完了です。