From: Nick Gaya Date: Fri, 11 Dec 2020 08:27:35 +0000 (-0800) Subject: bpo-41879: Doc: Fix description of async for statement (GH-23548) X-Git-Tag: v3.10.0a4~194 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4b8cdfcb22fbeaab9d954cb693a7fb3362a382b6;p=thirdparty%2FPython%2Fcpython.git bpo-41879: Doc: Fix description of async for statement (GH-23548) Fix the wording in the documentation of `async for` to correctly describe asynchronous iterables. This fix is relevant for version 3.7 onward. --- diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 62986cb15196..a55aacccc16d 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -796,12 +796,12 @@ The :keyword:`!async for` statement .. productionlist:: python-grammar async_for_stmt: "async" `for_stmt` -An :term:`asynchronous iterable` is able to call asynchronous code in its -*iter* implementation, and :term:`asynchronous iterator` can call asynchronous -code in its *next* method. +An :term:`asynchronous iterable` provides an ``__aiter__`` method that directly +returns an :term:`asynchronous iterator`, which can call asynchronous code in +its ``__anext__`` method. The ``async for`` statement allows convenient iteration over asynchronous -iterators. +iterables. The following code::