From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 18 Sep 2018 04:12:05 +0000 (-0700)
Subject: bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380)
X-Git-Tag: v3.7.1rc1~48
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1f4ea580675d7b30d3906d78c500997d7d96995d;p=thirdparty%2FPython%2Fcpython.git

bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380)

(cherry picked from commit ac94e38d076aebc56c2ff96a249b5e40f32633ea)

Co-authored-by: Yury Selivanov <yury@magic.io>
---

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
index 3b13a81a5b6a..252224218572 100644
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -152,8 +152,12 @@ Running and stopping the loop
    close with an :meth:`~agen.aclose()` call.  After calling this method,
    the event loop will issue a warning if a new asynchronous generator
    is iterated. This should be used to reliably finalize all scheduled
-   asynchronous generators, e.g.::
+   asynchronous generators.
 
+   Note that there is no need to call this function when
+   :func:`asyncio.run` is used.
+
+   Example::
 
     try:
         loop.run_forever()