From 9585f46b97931d2640c3343dfe03aed15beb9fea Mon Sep 17 00:00:00 2001 From: Windson yang Date: Fri, 13 Sep 2019 21:36:09 +0800 Subject: bpo-26468: Doc: improve the documentation of shutil.copy2 when it can fail. (GH-13765) --- 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 88c5f62..174b7e8 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -187,7 +187,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 -- cgit v0.12