From 8be9a2c07d1e2e4a42d9ed8cdf5d948df3a02b4f Mon Sep 17 00:00:00 2001 From: Windsooon Date: Mon, 3 Jun 2019 10:12:00 +0800 Subject: [PATCH] bpo-26468: note that shutil.copy2 would fail. --- Doc/library/shutil.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 4af5a16806088d..e2813d0d7c3023 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -185,7 +185,8 @@ Directory and files operations However, this functionality is not available on all platforms. On platforms where some or all of this functionality is unavailable, :func:`copy2` will preserve all the metadata - it can; :func:`copy2` never returns failure. + it can; :func:`copy2` never raises an exception because it + cannot preserve file metadata. :func:`copy2` uses :func:`copystat` to copy the file metadata. Please see :func:`copystat` for more information