From 9f428489c8d4f0819d2c8a24e1369d80f88e339d Mon Sep 17 00:00:00 2001 From: Inada Naoki Date: Mon, 15 Apr 2019 20:51:33 +0900 Subject: [PATCH] Doc: update PendingDeprecationWarning explanation Ref: https://github.com/python/cpython/pull/12505/files#r273978757 --- Doc/library/exceptions.rst | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst index 250938003c078c..52a505e0a0ff8f 100644 --- a/Doc/library/exceptions.rst +++ b/Doc/library/exceptions.rst @@ -691,16 +691,13 @@ The following exceptions are used as warning categories; see the .. exception:: PendingDeprecationWarning - Base class for warnings about features which will be deprecated in the - future. + Base class for warnings about features which are obsolete and + expected to be deprecated in the future, but are not deprecated + at the moment. - .. note:: - PendingDeprecationWarning was introduced as an "ignored by default" - version of DeprecationWarning. But :exc:`DeprecationWarning` is also - ignored by default since Python 2.7 and 3.2. - There is not much difference between PendingDeprecationWarning and - DeprecationWarning nowadays. DeprecationWarning is recommended - in general. + This class is rarely used as emitting a warning about a possible + upcoming deprecation is unusual, and :exc:`DeprecationWarning` + is preferred for already active deprecations. .. exception:: SyntaxWarning