diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2021-09-02 15:37:14 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-09-02 15:37:14 (GMT) |
| commit | 559af7434668e2950c08389515a52eba697ef6af (patch) | |
| tree | fceef2c26b4e425afaf704ceb9a8794395a2eb66 | |
| parent | 3d56272e4ecaef9f38c1f48430364701d34b3ee4 (diff) | |
| download | cpython-559af7434668e2950c08389515a52eba697ef6af.zip cpython-559af7434668e2950c08389515a52eba697ef6af.tar.gz cpython-559af7434668e2950c08389515a52eba697ef6af.tar.bz2 | |
bpo-40360: [doc] Rephrase deprecation note about lib2to3 (GH-28122)
(cherry picked from commit f0b63d5b56a6324f5f86807d9548c7b38aa2a8f7)
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
| -rw-r--r-- | Doc/library/2to3.rst | 15 |
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:: |