[Python-checkins] [3.11] gh-101454: fix documentation for END_ASYNC_FOR (#101455) (#101493)

iritkatriel webhook-mailer at python.org
Wed Feb 1 09:30:55 EST 2023


https://github.com/python/cpython/commit/c796d34b2a121bcb89c6afd79160f95ece7cc945
commit: c796d34b2a121bcb89c6afd79160f95ece7cc945
branch: 3.11
author: Irit Katriel <1055913+iritkatriel at users.noreply.github.com>
committer: iritkatriel <1055913+iritkatriel at users.noreply.github.com>
date: 2023-02-01T14:30:48Z
summary:

[3.11] gh-101454: fix documentation for END_ASYNC_FOR (#101455) (#101493)

gh-101454: fix documentation for END_ASYNC_FOR (#101455)

(cherry picked from commit 62251c3da06eb4662502295697f39730565b1717)

files:
M Doc/library/dis.rst

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 1e323bd50066..a61dd75cbeab 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -563,10 +563,9 @@ the original TOS1.
 .. opcode:: END_ASYNC_FOR
 
    Terminates an :keyword:`async for` loop.  Handles an exception raised
-   when awaiting a next item.  If TOS is :exc:`StopAsyncIteration` pop 3
-   values from the stack and restore the exception state using the second
-   of them.  Otherwise re-raise the exception using the value
-   from the stack.  An exception handler block is removed from the block stack.
+   when awaiting a next item. The stack contains the async iterable in
+   TOS1 and the raised exception in TOS. Both are popped.
+   If the exception is not :exc:`StopAsyncIteration`, it is re-raised.
 
    .. versionadded:: 3.8
 



More information about the Python-checkins mailing list