diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 62783a417e7583a..35bd17d3a2c1b16 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -1641,6 +1641,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