[Python-checkins] gh-101454: fix documentation for END_ASYNC_FOR (#101455)
iritkatriel
webhook-mailer at python.org
Wed Feb 1 07:50:28 EST 2023
https://github.com/python/cpython/commit/62251c3da06eb4662502295697f39730565b1717
commit: 62251c3da06eb4662502295697f39730565b1717
branch: main
author: Irit Katriel <1055913+iritkatriel at users.noreply.github.com>
committer: iritkatriel <1055913+iritkatriel at users.noreply.github.com>
date: 2023-02-01T12:49:59Z
summary:
gh-101454: fix documentation for END_ASYNC_FOR (#101455)
files:
M Doc/library/dis.rst
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 6a68ec4b14be..1fe2d5d6227d 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -616,10 +616,9 @@ not have to be) the original ``STACK[-2]``.
.. opcode:: END_ASYNC_FOR
Terminates an :keyword:`async for` loop. Handles an exception raised
- when awaiting a next item. If ``STACK[-1]`` 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
+ ``STACK[-2]`` and the raised exception in ``STACK[-1]``. 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