mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-14 04:37:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

bpo-36404: recommend DeprecationWarning over PendingDeprecationWarning (GH-12505)

Browse source
This commit is contained in:
Inada Naoki 2019-04-05 17:54:24 +09:00 • committed by GitHub
parent 2a4ce4387f
commit 176d26364b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 13 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/exceptions.rst
View file

@ -694,6 +694,14 @@ The following exceptions are used as warning categories; see the
Base class for warnings about features which will be deprecated in the Base class for warnings about features which will be deprecated in the
future. future.
.. 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.
.. exception:: SyntaxWarning .. exception:: SyntaxWarning

10
Doc/library/warnings.rst
View file

@ -109,11 +109,11 @@ The following warnings category classes are currently defined:
+----------------------------------+-----------------------------------------------+ +----------------------------------+-----------------------------------------------+
.. versionchanged:: 3.7 .. versionchanged:: 3.7
Previously :exc:`DeprecationWarning` and :exc:`FutureWarning` were Previously :exc:`DeprecationWarning` and :exc:`FutureWarning` were
distinguished based on whether a feature was being removed entirely or distinguished based on whether a feature was being removed entirely or
changing its behaviour. They are now distinguished based on their changing its behaviour. They are now distinguished based on their
intended audience and the way they're handled by the default warnings intended audience and the way they're handled by the default warnings
filters. filters.
.. _warning-filter: .. _warning-filter: