From: Simon Willison <swillison@gmail.com>
Date: Thu, 7 Jan 2021 02:03:18 +0000 (-0800)
Subject: bpo-42783: Documentation for asyncio.sleep(0) (#24002)
X-Git-Tag: v3.10.0a5~126
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5c30145afb6053998e3518befff638d207047f00;p=thirdparty%2FPython%2Fcpython.git

bpo-42783: Documentation for asyncio.sleep(0) (#24002)

Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
---

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index 45e58437e036..1ca1b4a06d7e 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -293,6 +293,10 @@ Sleeping
    ``sleep()`` always suspends the current task, allowing other tasks
    to run.
 
+   Setting the delay to 0 provides an optimized path to allow other
+   tasks to run. This can be used by long-running functions to avoid
+   blocking the event loop for the full duration of the function call.
+
    .. _asyncio_example_sleep:
 
    Example of coroutine displaying the current date every second