Skip to content

Commit ff83499

Browse files
authored
GH-124985: Document that pathlib.Path.copy() uses copy-on-write. (#125861)
1 parent 8525c93 commit ff83499

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

Doc/library/pathlib.rst

+5
Original file line numberDiff line numberDiff line change
@@ -1592,6 +1592,11 @@ Copying, moving and deleting
15921592
This argument has no effect when copying files on Windows (where
15931593
metadata is always preserved).
15941594

1595+
.. note::
1596+
Where supported by the operating system and file system, this method
1597+
performs a lightweight copy, where data blocks are only copied when
1598+
modified. This is known as copy-on-write.
1599+
15951600
.. versionadded:: 3.14
15961601

15971602

0 commit comments

Comments
 (0)