bpo-36404: recommend DeprecationWarning over PendingDeprecationWarnin… · python/cpython@176d263 (original) (raw)

Original file line number Diff line number Diff line change
@@ -694,6 +694,14 @@ The following exceptions are used as warning categories; see the
694 694 Base class for warnings about features which will be deprecated in the
695 695 future.
696 696
697 + .. note::
698 + PendingDeprecationWarning was introduced as an "ignored by default"
699 + version of DeprecationWarning. But :exc:`DeprecationWarning` is also
700 + ignored by default since Python 2.7 and 3.2.
701 + There is not much difference between PendingDeprecationWarning and
702 + DeprecationWarning nowadays. DeprecationWarning is recommended
703 + in general.
704 +
697 705
698 706 .. exception:: SyntaxWarning
699 707