From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sun, 28 Sep 2025 19:02:33 +0000 (+0200) Subject: [3.14] gh-135447: Document the ``NOT_TAKEN`` & ``POP_ITER`` bytecode instructions... X-Git-Tag: v3.14.0~38 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c82079e0b4e48e6131f20c099246e159e55f7f4b;p=thirdparty%2FPython%2Fcpython.git [3.14] gh-135447: Document the ``NOT_TAKEN`` & ``POP_ITER`` bytecode instructions (GH-135803) (#139399) Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com> 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::