summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorƁukasz Langa <lukasz@langa.pl>2021-09-02 15:12:49 (GMT)
committerGitHub <noreply@github.com>2021-09-02 15:12:49 (GMT)
commitf0b63d5b56a6324f5f86807d9548c7b38aa2a8f7 (patch)
tree411f36e2c266b5697c2d452cac4336c9bb3c0466 /Doc/library
parentea23e7820f02840368569db8082bd0ca4d59b62a (diff)
downloadcpython-f0b63d5b56a6324f5f86807d9548c7b38aa2a8f7.zip
cpython-f0b63d5b56a6324f5f86807d9548c7b38aa2a8f7.tar.gz
cpython-f0b63d5b56a6324f5f86807d9548c7b38aa2a8f7.tar.bz2
bpo-40360: [doc] Rephrase deprecation note about lib2to3 (GH-28122)
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/2to3.rst15
1 files changed, 9 insertions, 6 deletions
diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst
index 1d7bd26..2a13776 100644
--- a/Doc/library/2to3.rst
+++ b/Doc/library/2to3.rst
@@ -464,12 +464,15 @@ and off individually. They are described here in more detail.
--------------
-.. deprecated:: 3.10
- Python 3.9 will switch to a PEG parser (see :pep:`617`), and Python 3.10 may
- include new language syntax that is not parsable by lib2to3's LL(1) parser.
- The ``lib2to3`` module may be removed from the standard library in a future
- Python version. Consider third-party alternatives such as `LibCST`_ or
- `parso`_.
+.. deprecated-removed:: 3.11 3.13
+ Python 3.9 switched to a PEG parser (see :pep:`617`) while lib2to3 is
+ using a less flexible LL(1) parser. Python 3.10 includes new language
+ syntax that is not parsable by lib2to3's LL(1) parser (see :pep:`634`).
+ The ``lib2to3`` module was marked pending for deprecation in Python 3.9
+ (raising :exc:`PendingDeprecationWarning` on import) and fully deprecated
+ in Python 3.11 (raising :exc:`DeprecationWarning`).
+ It will be removed from the standard library in Python 3.13.
+ Consider third-party alternatives such as `LibCST`_ or `parso`_.
.. note::