[Python-checkins] bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380)

[Yury Selivanov]

https://github.com/python/cpython/commit/ac94e38d076aebc56c2ff96a249b5e40f32633ea
commit: ac94e38d076aebc56c2ff96a249b5e40f32633ea
branch: master
author: Yury Selivanov <yury at magic.io>
committer: GitHub <noreply at github.com>
date: 2018-09-17T23:58:00-04:00
summary:

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

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

diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
index 0320d798c1e5..20d18c02976b 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()