From: Irit Katriel <1055913+iritkatriel@users.noreply.github.com>
Date: Wed, 1 Feb 2023 12:49:59 +0000 (+0000)
Subject: gh-101454: fix documentation for END_ASYNC_FOR (#101455)
X-Git-Tag: v3.12.0a5~52
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=62251c3da06eb4662502295697f39730565b1717;p=thirdparty%2FPython%2Fcpython.git

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

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