]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.12] gh-114104: clarify asynchronous comprehension docs to match runtime behavior...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Mon, 1 Jul 2024 16:41:18 +0000 (18:41 +0200)
committerGitHub <noreply@github.com>
Mon, 1 Jul 2024 16:41:18 +0000 (16:41 +0000)
gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175)
(cherry picked from commit 91313afdb392d0d6105e9aaa57b5a50112b613e7)

Co-authored-by: Danny Yang <yangdanny97@users.noreply.github.com>
Doc/reference/expressions.rst

index 7c1dc6c0dc75eefe070f8a92ed66d098651e7ac9..57a5bd13070940d3a4eb994c75c4d61bde91c2ea 100644 (file)
@@ -218,10 +218,12 @@ A comprehension in an :keyword:`!async def` function may consist of either a
 :keyword:`!for` or :keyword:`!async for` clause following the leading
 expression, may contain additional :keyword:`!for` or :keyword:`!async for`
 clauses, and may also use :keyword:`await` expressions.
-If a comprehension contains either :keyword:`!async for` clauses or
-:keyword:`!await` expressions or other asynchronous comprehensions it is called
-an :dfn:`asynchronous comprehension`.  An asynchronous comprehension may
-suspend the execution of the coroutine function in which it appears.
+
+If a comprehension contains :keyword:`!async for` clauses, or if it contains
+:keyword:`!await` expressions or other asynchronous comprehensions anywhere except
+the iterable expression in the leftmost :keyword:`!for` clause, it is called an
+:dfn:`asynchronous comprehension`. An asynchronous comprehension may suspend the
+execution of the coroutine function in which it appears.
 See also :pep:`530`.
 
 .. versionadded:: 3.6