diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index abcc3cde23526c..4c3ddb615aa7f3 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1128,7 +1128,10 @@ iterations of the loop.
 .. opcode:: COMPARE_OP (opname)
 
    Performs a Boolean operation.  The operation name can be found in
-   ``cmp_op[opname]``.
+   ``cmp_op[opname >> 4]``.
+
+   .. versionchanged:: 3.12
+     The cmp_op index is now stored in the four-highest bits of oparg instead of the four-lowest bits of oparg.
 
 
 .. opcode:: IS_OP (invert)