mirror of https://github.com/python/cpython
gh-92611: Clarify planned removal version in PEP 594-deprecated modules (GH-92793)
As discussed in #92611 and #92564 and as a followup to PR #92612 , this 3.11+ only PR uses the proper `deprecated-removed` role for the modules deprecated by PEP 593 (PEP-594) to clearly indicate to users that a removal version is planned and what it is, so they can prepare accordingly or voice any unanticipated impacts. Related to #92792 ; if we decide to backport that PR, the upgrade to using `deprecated-removed` on those functions can be moved to this one.
This commit is contained in:
parent
87b9b4e060
commit
31fa41ed68
|
@ -13,7 +13,7 @@
|
||||||
single: AIFF-C
|
single: AIFF-C
|
||||||
|
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`aifc` module is deprecated
|
The :mod:`aifc` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#aifc>` for details).
|
(see :pep:`PEP 594 <594#aifc>` for details).
|
||||||
|
|
||||||
|
|
|
@ -10,8 +10,8 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/asynchat.py`
|
**Source code:** :source:`Lib/asynchat.py`
|
||||||
|
|
||||||
.. deprecated:: 3.6
|
.. deprecated-removed:: 3.6 3.12
|
||||||
:mod:`asynchat` will be removed in Python 3.12
|
The :mod:`asynchat` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#asynchat>` for details).
|
(see :pep:`PEP 594 <594#asynchat>` for details).
|
||||||
Please use :mod:`asyncio` instead.
|
Please use :mod:`asyncio` instead.
|
||||||
|
|
||||||
|
|
|
@ -13,8 +13,8 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/asyncore.py`
|
**Source code:** :source:`Lib/asyncore.py`
|
||||||
|
|
||||||
.. deprecated:: 3.6
|
.. deprecated-removed:: 3.6 3.12
|
||||||
:mod:`asyncore` will be removed in Python 3.12
|
The :mod:`asyncore` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#asyncore>` for details).
|
(see :pep:`PEP 594 <594#asyncore>` for details).
|
||||||
Please use :mod:`asyncio` instead.
|
Please use :mod:`asyncio` instead.
|
||||||
|
|
||||||
|
|
|
@ -5,7 +5,7 @@
|
||||||
:synopsis: Manipulate raw audio data.
|
:synopsis: Manipulate raw audio data.
|
||||||
:deprecated:
|
:deprecated:
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`audioop` module is deprecated
|
The :mod:`audioop` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#audioop>` for details).
|
(see :pep:`PEP 594 <594#audioop>` for details).
|
||||||
|
|
||||||
|
|
|
@ -15,7 +15,7 @@
|
||||||
single: URL
|
single: URL
|
||||||
single: Common Gateway Interface
|
single: Common Gateway Interface
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`cgi` module is deprecated
|
The :mod:`cgi` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#cgi>` for details and alternatives).
|
(see :pep:`PEP 594 <594#cgi>` for details and alternatives).
|
||||||
|
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
single: exceptions; in CGI scripts
|
single: exceptions; in CGI scripts
|
||||||
single: tracebacks; in CGI scripts
|
single: tracebacks; in CGI scripts
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`cgitb` module is deprecated
|
The :mod:`cgitb` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#cgitb>` for details).
|
(see :pep:`PEP 594 <594#cgitb>` for details).
|
||||||
|
|
||||||
|
|
|
@ -17,7 +17,7 @@
|
||||||
single: Real Media File Format
|
single: Real Media File Format
|
||||||
single: RMFF
|
single: RMFF
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`chunk` module is deprecated
|
The :mod:`chunk` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#chunk>` for details).
|
(see :pep:`PEP 594 <594#chunk>` for details).
|
||||||
|
|
||||||
|
|
|
@ -16,7 +16,7 @@
|
||||||
single: crypt(3)
|
single: crypt(3)
|
||||||
pair: cipher; DES
|
pair: cipher; DES
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`crypt` module is deprecated
|
The :mod:`crypt` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#crypt>` for details and alternatives).
|
(see :pep:`PEP 594 <594#crypt>` for details and alternatives).
|
||||||
The :mod:`hashlib` module is a potential replacement for certain use cases.
|
The :mod:`hashlib` module is a potential replacement for certain use cases.
|
||||||
|
|
|
@ -7,7 +7,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/imghdr.py`
|
**Source code:** :source:`Lib/imghdr.py`
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`imghdr` module is deprecated
|
The :mod:`imghdr` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#imghdr>` for details and alternatives).
|
(see :pep:`PEP 594 <594#imghdr>` for details and alternatives).
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/imp.py`
|
**Source code:** :source:`Lib/imp.py`
|
||||||
|
|
||||||
.. deprecated:: 3.4
|
.. deprecated-removed:: 3.4 3.12
|
||||||
The :mod:`imp` module is deprecated in favor of :mod:`importlib`.
|
The :mod:`imp` module is deprecated in favor of :mod:`importlib`.
|
||||||
|
|
||||||
.. index:: statement: import
|
.. index:: statement: import
|
||||||
|
|
|
@ -7,7 +7,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/mailcap.py`
|
**Source code:** :source:`Lib/mailcap.py`
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`mailcap` module is deprecated
|
The :mod:`mailcap` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#mailcap>` for details).
|
(see :pep:`PEP 594 <594#mailcap>` for details).
|
||||||
The :mod:`mimetypes` module provides an alternative.
|
The :mod:`mimetypes` module provides an alternative.
|
||||||
|
|
|
@ -13,7 +13,7 @@
|
||||||
|
|
||||||
.. index:: single: msi
|
.. index:: single: msi
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`msilib` module is deprecated
|
The :mod:`msilib` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#msilib>` for details).
|
(see :pep:`PEP 594 <594#msilib>` for details).
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
.. moduleauthor:: Fred Gansevles <Fred.Gansevles@cs.utwente.nl>
|
.. moduleauthor:: Fred Gansevles <Fred.Gansevles@cs.utwente.nl>
|
||||||
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
|
.. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`nis` module is deprecated
|
The :mod:`nis` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#nis>` for details).
|
(see :pep:`PEP 594 <594#nis>` for details).
|
||||||
|
|
||||||
|
|
|
@ -6,7 +6,7 @@
|
||||||
:synopsis: Access to OSS-compatible audio devices.
|
:synopsis: Access to OSS-compatible audio devices.
|
||||||
:deprecated:
|
:deprecated:
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`ossaudiodev` module is deprecated
|
The :mod:`ossaudiodev` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#ossaudiodev>` for details).
|
(see :pep:`PEP 594 <594#ossaudiodev>` for details).
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/pipes.py`
|
**Source code:** :source:`Lib/pipes.py`
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`pipes` module is deprecated
|
The :mod:`pipes` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#pipes>` for details).
|
(see :pep:`PEP 594 <594#pipes>` for details).
|
||||||
Please use the :mod:`subprocess` module instead.
|
Please use the :mod:`subprocess` module instead.
|
||||||
|
|
|
@ -14,8 +14,8 @@
|
||||||
|
|
||||||
This module offers several classes to implement SMTP (email) servers.
|
This module offers several classes to implement SMTP (email) servers.
|
||||||
|
|
||||||
.. deprecated:: 3.6
|
.. deprecated-removed:: 3.6 3.12
|
||||||
:mod:`smtpd` will be removed in Python 3.12
|
The :mod:`smtpd` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#smtpd>` for details).
|
(see :pep:`PEP 594 <594#smtpd>` for details).
|
||||||
The `aiosmtpd <https://aiosmtpd.readthedocs.io/>`_ package is a recommended
|
The `aiosmtpd <https://aiosmtpd.readthedocs.io/>`_ package is a recommended
|
||||||
replacement for this module. It is based on :mod:`asyncio` and provides a
|
replacement for this module. It is based on :mod:`asyncio` and provides a
|
||||||
|
|
|
@ -14,7 +14,7 @@
|
||||||
single: A-LAW
|
single: A-LAW
|
||||||
single: u-LAW
|
single: u-LAW
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`sndhdr` module is deprecated
|
The :mod:`sndhdr` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#sndhdr>` for details and alternatives).
|
(see :pep:`PEP 594 <594#sndhdr>` for details and alternatives).
|
||||||
|
|
||||||
|
|
|
@ -6,7 +6,7 @@
|
||||||
:synopsis: The shadow password database (getspnam() and friends).
|
:synopsis: The shadow password database (getspnam() and friends).
|
||||||
:deprecated:
|
:deprecated:
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`spwd` module is deprecated
|
The :mod:`spwd` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#spwd>` for details and alternatives).
|
(see :pep:`PEP 594 <594#spwd>` for details and alternatives).
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/sunau.py`
|
**Source code:** :source:`Lib/sunau.py`
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`sunau` module is deprecated
|
The :mod:`sunau` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#sunau>` for details).
|
(see :pep:`PEP 594 <594#sunau>` for details).
|
||||||
|
|
||||||
|
|
|
@ -11,7 +11,7 @@
|
||||||
|
|
||||||
.. index:: single: protocol; Telnet
|
.. index:: single: protocol; Telnet
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`telnetlib` module is deprecated
|
The :mod:`telnetlib` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#telnetlib>` for details and alternatives).
|
(see :pep:`PEP 594 <594#telnetlib>` for details and alternatives).
|
||||||
|
|
||||||
|
|
|
@ -9,7 +9,7 @@
|
||||||
|
|
||||||
**Source code:** :source:`Lib/uu.py`
|
**Source code:** :source:`Lib/uu.py`
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`uu` module is deprecated
|
The :mod:`uu` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#uu-and-the-uu-encoding>` for details).
|
(see :pep:`PEP 594 <594#uu-and-the-uu-encoding>` for details).
|
||||||
:mod:`base64` is a modern alternative.
|
:mod:`base64` is a modern alternative.
|
||||||
|
|
|
@ -11,7 +11,7 @@
|
||||||
single: XDR
|
single: XDR
|
||||||
single: External Data Representation
|
single: External Data Representation
|
||||||
|
|
||||||
.. deprecated:: 3.11
|
.. deprecated-removed:: 3.11 3.13
|
||||||
The :mod:`xdrlib` module is deprecated
|
The :mod:`xdrlib` module is deprecated
|
||||||
(see :pep:`PEP 594 <594#xdrlib>` for details).
|
(see :pep:`PEP 594 <594#xdrlib>` for details).
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue