From: Tian Gao <gaogaotiantian@hotmail.com>
Date: Sun, 4 Feb 2024 22:27:17 +0000 (-0800)
Subject: [3.12] gh-114480: Add docs for f_trace_opcodes behavior on 3.12 (#114540)
X-Git-Tag: v3.12.2~17
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=27cacdd5b4788fa23f618b4d8d1d0ebf8b740930;p=thirdparty%2FPython%2Fcpython.git

[3.12] gh-114480: Add docs for f_trace_opcodes behavior on 3.12 (#114540)
---

diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 4bd769ea9ae5..198422307bac 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -1644,6 +1644,12 @@ always available.
       ``'opcode'`` event type added; :attr:`~frame.f_trace_lines` and
       :attr:`~frame.f_trace_opcodes` attributes added to frames
 
+   .. versionchanged:: 3.12
+      ``'opcode'`` event will only be emitted if :attr:`~frame.f_trace_opcodes`
+      of at least one frame has been set to :const:`True` before :func:`settrace`
+      is called. This behavior will be changed back in 3.13 to be consistent with
+      previous versions.
+
 .. function:: set_asyncgen_hooks([firstiter] [, finalizer])
 
    Accepts two optional keyword arguments which are callables that accept an