[Python-checkins] bpo-34476: Document that asyncio.sleep() always suspends. (GH-9643) (#9654)

[Andrew Svetlov]

https://github.com/python/cpython/commit/655608a1112e592cd6a9155ebe774dd285f561f3
commit: 655608a1112e592cd6a9155ebe774dd285f561f3
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Andrew Svetlov <andrew.svetlov at gmail.com>
date: 2018-10-01T13:19:33+03:00
summary:

bpo-34476: Document that asyncio.sleep() always suspends. (GH-9643) (#9654)

(cherry picked from commit cd602b8af2d14ff686261eeb18b80f718bb16550)

Co-authored-by: Hrvoje Nikšić <hniksic at gmail.com>

files:
M Doc/library/asyncio-task.rst

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index 198bd7d07a01..3168f478f3c0 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -270,6 +270,9 @@ Sleeping
    If *result* is provided, it is returned to the caller
    when the coroutine completes.
 
+   ``sleep()`` always suspends the current task, allowing other tasks
+   to run.
+
    The *loop* argument is deprecated and scheduled for removal
    in Python 3.10.