From: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com> Date: Sun, 28 Sep 2025 16:46:01 +0000 (+0800) Subject: gh-135447: Document the ``NOT_TAKEN`` & ``POP_ITER`` bytecode instructions (#135803) X-Git-Tag: v3.15.0a1~191 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=519bc470fc874b9aaad8eed0de7b99736d18c09f;p=thirdparty%2FPython%2Fcpython.git gh-135447: Document the ``NOT_TAKEN`` & ``POP_ITER`` bytecode instructions (#135803) Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Ken Jin --- diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index 21bd1db5f338..711ef55def69 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -585,6 +585,22 @@ operations on it as if it was a Python list. The top of the stack corresponds to generate line tracing events. +.. opcode:: NOT_TAKEN + + Do nothing code. + Used by the interpreter to record :monitoring-event:`BRANCH_LEFT` + and :monitoring-event:`BRANCH_RIGHT` events for :mod:`sys.monitoring`. + + .. versionadded:: 3.14 + + +.. opcode:: POP_ITER + + Removes the iterator from the top of the stack. + + .. versionadded:: 3.14 + + .. opcode:: POP_TOP Removes the top-of-stack item::