Issue #29316: Restore the provisional status of typing module and add

corresponding note to documentation. Patch by Ivan L.

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index fd6bded005e2936055b86321d267af4c2e4a4e1b..cd59d10ca295a9c06969f7aebd24e227b7ba1af0 100644 (file)
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -8,6 +8,13 @@
 
 **Source code:** :source:`Lib/typing.py`
 
+.. note::
+
+   The typing module has been included in the standard library on a
+   :term:`provisional basis <provisional api>`. New features might
+   be added and API may change even between minor releases if deemed
+   necessary by the core developers.
+
 --------------
 
 This module supports type hints as specified by :pep:`484` and :pep:`526`.

diff --git a/Doc/whatsnew/3.6.rst b/Doc/whatsnew/3.6.rst
index 2c5b0f499a6e038ea41733058aed3b1183eb6781..f6c71d374c59444c8eaed4b2a9d3c01b32efcf49 100644 (file)
--- a/Doc/whatsnew/3.6.rst
+++ b/Doc/whatsnew/3.6.rst
@@ -120,7 +120,7 @@ Significant improvements in the standard library:
   :ref:`Local Time Disambiguation <whatsnew36-pep495>`.
 
 * The :mod:`typing` module received a number of
-  :ref:`improvements <whatsnew36-typing>` and is no longer provisional.
+  :ref:`improvements <whatsnew36-typing>`.
 
 * The :mod:`tracemalloc` module has been significantly reworked
   and is now used to provide better output for :exc:`ResourceWarning`
@@ -1544,11 +1544,8 @@ to filter block traces by their address space (domain).
 typing
 ------
 
-Starting with Python 3.6 the :mod:`typing` module is no longer provisional
-and its API is considered stable.
-
-Since the :mod:`typing` module was :term:`provisional <provisional api>`
-in Python 3.5, all changes introduced in Python 3.6 have also been
+Since the :mod:`typing` module is :term:`provisional <provisional api>`,
+all changes introduced in Python 3.6 have also been
 backported to Python 3.5.x.
 
 The :mod:`typing` module has a much improved support for generic type

diff --git a/Misc/NEWS b/Misc/NEWS
index 138539b41877247bf1d8a3e775cbd0f96225913e..9f62022e375cd98a3e467ca297a44e59e8f13a37 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -47,6 +47,9 @@ Core and Builtins
 Library
 -------
 
+- Issue #29316: Restore the provisional status of typing module, add
+  corresponding note to documentation. Patch by Ivan L.
+
 - Issue #29219: Fixed infinite recursion in the repr of uninitialized
   ctypes.CDLL instances.