[Python-checkins] (no subject)

[Stéphane Wirtel]

To: python-checkins at python.org
Subject: bpo-26468: Doc: improve the documentation of shutil.copy2 when it can
 fail. (GH-13765)
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

https://github.com/python/cpython/commit/9585f46b97931d2640c3343dfe03aed15beb=
9fea
commit: 9585f46b97931d2640c3343dfe03aed15beb9fea
branch: master
author: Windson yang <wiwindson at outlook.com>
committer: St=C3=A9phane Wirtel <stephane at wirtel.be>
date: 2019-09-13T14:36:09+01:00
summary:

bpo-26468: Doc: improve the documentation of shutil.copy2 when it can fail. (=
GH-13765)

files:
M Doc/library/shutil.rst

diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 88c5f62dd4c9..174b7e875a38 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.
=20
    :func:`copy2` uses :func:`copystat` to copy the file metadata.
    Please see :func:`copystat` for more information