From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 23 May 2020 23:23:53 +0000 (-0700)
Subject: bpo-40405: Fix asyncio.as_completed docs (GH-19753)
X-Git-Tag: v3.9.0b2~104
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9181e2e2f3ade85f65bf2521a5deb898434dfd64;p=thirdparty%2FPython%2Fcpython.git

bpo-40405: Fix asyncio.as_completed docs (GH-19753)


* Fix as_completed docs to correctly state the function return value.
* Also, improves the general wording of the as_completed documentation.

Co-Authored-By: Rémi Lapeyre <remi.lapeyre@henki.fr>
Co-Authored-By: Kyle Stanley <aeros167@gmail.com>
Co-Authored-By: Yury Selivanov <yury@edgedb.com>
(cherry picked from commit 13206b52d16c2489f4c7dd2dce2a7f48a554b5ed)

Co-authored-by: Bar Harel <bzvi7919@gmail.com>
---

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index dd94c1485483..847363b134a7 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -585,9 +585,9 @@ Waiting Primitives
 .. function:: as_completed(aws, \*, loop=None, timeout=None)
 
    Run :ref:`awaitable objects <asyncio-awaitables>` in the *aws*
-   set concurrently.  Return an iterator of :class:`Future` objects.
-   Each Future object returned represents the earliest result
-   from the set of the remaining awaitables.
+   set concurrently.  Return an iterator of coroutines.
+   Each coroutine returned can be awaited to get the earliest next
+   result from the set of the remaining awaitables.
 
    Raises :exc:`asyncio.TimeoutError` if the timeout occurs before
    all Futures are done.
@@ -597,8 +597,8 @@ Waiting Primitives
 
    Example::
 
-       for f in as_completed(aws):
-           earliest_result = await f
+       for coro in as_completed(aws):
+           earliest_result = await coro
            # ...