From 503e547436c32ba3250df492d8680e38cfe11e37 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Thu, 2 Sep 2021 11:59:07 +0200 Subject: [PATCH 1/2] bpo-40360: [doc] Rephrase deprecation note about lib2to3 --- Doc/library/2to3.rst | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst index 1d7bd262872905..3ad11ee2c73f29 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:: 3.11 + 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 a future Python version. + Consider third-party alternatives such as `LibCST`_ or `parso`_. .. note:: From 4872f1f899031eb126c18b008d5c7c92919beadc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Langa?= Date: Thu, 2 Sep 2021 16:42:34 +0200 Subject: [PATCH 2/2] Be more specific about removal time --- Doc/library/2to3.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst index 3ad11ee2c73f29..2a13776e29336c 100644 --- a/Doc/library/2to3.rst +++ b/Doc/library/2to3.rst @@ -464,14 +464,14 @@ and off individually. They are described here in more detail. -------------- -.. deprecated:: 3.11 +.. 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 a future Python version. + It will be removed from the standard library in Python 3.13. Consider third-party alternatives such as `LibCST`_ or `parso`_. .. note::