From: Łukasz Langa <lukasz@langa.pl>
Date: Thu, 2 Sep 2021 15:12:49 +0000 (+0200)
Subject: bpo-40360: [doc] Rephrase deprecation note about lib2to3 (GH-28122)
X-Git-Tag: v3.11.0a1~275
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f0b63d5b56a6324f5f86807d9548c7b38aa2a8f7;p=thirdparty%2FPython%2Fcpython.git

bpo-40360: [doc] Rephrase deprecation note about lib2to3 (GH-28122)
---

diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst
index 1d7bd2628729..2a13776e2933 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::