From 1c73e69ec5fb342414489f98e825c74c354327dc Mon Sep 17 00:00:00 2001
From: Yury Selivanov <yselivanov@sprymix.com>
Date: Thu, 10 Sep 2015 18:59:42 -0400
Subject: [PATCH] whatsnew/3.5: Clarify types.coroutine & types.CoroutineType

---
 Doc/whatsnew/3.5.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/Doc/whatsnew/3.5.rst b/Doc/whatsnew/3.5.rst
index a3721224d85..40598011c4b 100644
--- a/Doc/whatsnew/3.5.rst
+++ b/Doc/whatsnew/3.5.rst
@@ -1380,11 +1380,15 @@ now support negative values for the *limit* argument.
 types
 -----
 
-New :func:`~types.coroutine` function.  (Contributed by Yury Selivanov
-in :issue:`24017`.)
+A new :func:`~types.coroutine` function to transform
+:term:`generator <generator iterator>` and
+:class:`generator-like <collections.abc.Generator>` objects into
+:term:`awaitables <awaitable>`.
+(Contributed by Yury Selivanov in :issue:`24017`.)
 
-New :class:`~types.CoroutineType`.  (Contributed by Yury Selivanov
-in :issue:`24400`.)
+A new :class:`~types.CoroutineType` is the type of :term:`coroutine` objects,
+produced by calling a function defined with an :keyword:`async def` statement.
+(Contributed by Yury Selivanov in :issue:`24400`.)
 
 
 urllib