[Python-checkins] bpo-29879: Update typing documentation. (GH-4573)

Sun Nov 26 17:23:05 EST 2017

https://github.com/python/cpython/commit/0cd2e81bea639828d7c9a7afc61fb1da9699492c
commit: 0cd2e81bea639828d7c9a7afc61fb1da9699492c
branch: master
author: Ivan Levkivskyi <levkivskyi at gmail.com>
committer: Mariatta <Mariatta at users.noreply.github.com>
date: 2017年11月26日T14:23:02-08:00
summary:
bpo-29879: Update typing documentation. (GH-4573)
- Add "version added: 3.5.2" note where it was missing.
- Remove the mention that Reversible is new in 3.5.2
files:
M Doc/library/typing.rst
M Misc/NEWS.d/3.5.2rc1.rst

diff --git a/Doc/library/typing.rst b/Doc/library/typing.rst
index 9883d8bbe86..d28a5d54843 100644
--- a/Doc/library/typing.rst
+++ b/Doc/library/typing.rst
@@ -146,6 +146,8 @@ See :pep:`484` for more details.
 ``Derived`` is expected. This is useful when you want to prevent logic
 errors with minimal runtime cost.
 
+.. versionadded:: 3.5.2
+
 Callable
 --------
 
@@ -494,6 +496,8 @@ The module defines the following classes, functions and decorators:
 ``Type[Any]`` is equivalent to ``Type`` which in turn is equivalent
 to ``type``, which is the root of Python's metaclass hierarchy.
 
+ .. versionadded:: 3.5.2
+
 .. class:: Iterable(Generic[T_co])
 
 A generic version of :class:`collections.abc.Iterable`.
@@ -674,6 +678,8 @@ The module defines the following classes, functions and decorators:
 
 A generic version of :class:`collections.defaultdict`.
 
+ .. versionadded:: 3.5.2
+
 .. class:: Counter(collections.Counter, Dict[T, int])
 
 A generic version of :class:`collections.Counter`.
@@ -762,6 +768,8 @@ The module defines the following classes, functions and decorators:
 def add_unicode_checkmark(text: Text) -> Text:
 return text + u' \u2713'
 
+ .. versionadded:: 3.5.2
+
 .. class:: io
 
 Wrapper namespace for I/O stream types.
@@ -847,6 +855,8 @@ The module defines the following classes, functions and decorators:
 UserId = NewType('UserId', int)
 first_user = UserId(1)
 
+ .. versionadded:: 3.5.2
+
 .. function:: cast(typ, val)
 
 Cast a value to a type.
@@ -1054,3 +1064,5 @@ The module defines the following classes, functions and decorators:
 "forward reference", to hide the ``expensive_mod`` reference from the
 interpreter runtime. Type annotations for local variables are not
 evaluated, so the second annotation does not need to be enclosed in quotes.
+
+ .. versionadded:: 3.5.2
diff --git a/Misc/NEWS.d/3.5.2rc1.rst b/Misc/NEWS.d/3.5.2rc1.rst
index c33dcb2309f..caed84a06f7 100644
--- a/Misc/NEWS.d/3.5.2rc1.rst
+++ b/Misc/NEWS.d/3.5.2rc1.rst
@@ -420,7 +420,7 @@ patch by ingrid.
 .. section: Library
 
 A new version of typing.py provides several new classes and features:
- at overload outside stubs, Reversible, DefaultDict, Text, ContextManager,
+ at overload outside stubs, DefaultDict, Text, ContextManager,
 Type[], NewType(), TYPE_CHECKING, and numerous bug fixes (note that some of
 the new features are not yet implemented in mypy or other static analyzers).
 Also classes for PEP 492 (Awaitable, AsyncIterable, AsyncIterator) have been
