pythonGH-124985: Document that pathlib.Path.copy() uses copy-on-write.

barneygale · Oct 22, 2024 · d92267a · d92267a
1 parent 34653bb
commit d92267a
Showing 1 changed file with 5 additions and 0 deletions.
diff --git 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