From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Mon, 1 Jul 2024 16:51:43 +0000 (+0200) Subject: [3.13] gh-114104: clarify asynchronous comprehension docs to match runtime behavior... X-Git-Tag: v3.13.0b4~141 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=931c168219fc030d4b8a6986da4bb2a5a8ef91fa;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175) (#121234) gh-114104: clarify asynchronous comprehension docs to match runtime behavior (GH-121175) (cherry picked from commit 91313afdb392d0d6105e9aaa57b5a50112b613e7) Co-authored-by: Danny Yang --- diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst index 872773f4d282..95ece0e1608d 100644 --- a/Doc/reference/expressions.rst +++ b/Doc/reference/expressions.rst @@ -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