[3.7] bpo-36404: update PendingDeprecationWarning explanation (GH-12837) by miss-islington · Pull Request #12838 · python/cpython

Expand Up @@ -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 Expand Down