From d92267ade1428ffa706891a00ca1313e54f56105 Mon Sep 17 00:00:00 2001
From: barneygale <barney.gale@gmail.com>
Date: Wed, 23 Oct 2024 00:46:57 +0100
Subject: [PATCH] GH-124985: Document that `pathlib.Path.copy()` uses
 copy-on-write.

---
 Doc/library/pathlib.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 4380122eb1be7d..4b48880d6d9a18 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1563,6 +1563,11 @@ Copying, moving and deleting
    This argument has no effect when copying files on Windows (where
    metadata is always preserved).
 
+   .. note::
+      Where supported by the operating system and file system, this method
+      performs a lightweight copy, where data blocks are only copied when
+      modified. This is known as copy-on-write.
+
    .. versionadded:: 3.14