python · gpshead · Apr 22, 2020 · Apr 22, 2020
diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst
@@ -3,6 +3,12 @@
 2to3 - Automated Python 2 to 3 code translation
 ===============================================
 
+.. deprecated:: 3.9
+   The :mod:`lib2to3` package and related 2to3 tool are pending deprecation
+   and removal by Python 3.11 or 3.12.  We anticipate that a fork of it may
+   live on as an external package on PyPI as it does have use as a Python to
+   Python source transformation tool.
+
 .. sectionauthor:: Benjamin Peterson <benjamin@python.org>
 
 2to3 is a Python program that reads Python 2.x source code and applies a series
@@ -462,6 +468,11 @@ and off individually.  They are described here in more detail.
 .. moduleauthor:: Collin Winter
 .. moduleauthor:: Benjamin Peterson <benjamin@python.org>
 
+.. deprecated:: 3.9
+   The :mod:`lib2to3` package and related 2to3 tool are pending deprecation
+   and removal by Python 3.11 or 3.12.  We anticipate that a fork of it may
+   live on as an external package on PyPI.
+
 **Source code:** :source:`Lib/lib2to3/`
 
 --------------

diff --git a/Lib/lib2to3/__init__.py b/Lib/lib2to3/__init__.py
@@ -1 +1,5 @@
-#empty
+import warnings
+warnings.warn(
+    "lib2to3 is pending deprecation for removal in Python 3.11 or 3.12.",
+    category=PendingDeprecationWarning)
+del warnings
diff --git a/Misc/NEWS.d/next/Library/2020-04-21-22-04-57.bpo-40360.qCpoH8.rst b/Misc/NEWS.d/next/Library/2020-04-21-22-04-57.bpo-40360.qCpoH8.rst
@@ -0,0 +1,2 @@
+lib2to3 and the 2to3 tool gain a PendingDeprecationWarning, slated for
+removal in 3.11 or 3.12.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		lib2to3 and the 2to3 tool gain a PendingDeprecationWarning, slated for
		removal in 3.11 or 3.12.