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

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