diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml
index 3d45f0d638f4..c1077de44303 100644
--- a/reference/opcache/ini.xml
+++ b/reference/opcache/ini.xml
@@ -1158,7 +1158,8 @@ function getA() { return A; }
      <member><literal>off</literal>:  Disabled, but can be enabled at runtime.</member>
      <member>
       <literal>tracing</literal>/<literal>on</literal>: Use tracing JIT.
-      Enabled by default and recommended for most users.
+      Recommended for most users. Prior to PHP 8.4.0, this was the default
+      value; as of PHP 8.4.0 the default is <literal>disable</literal>.
      </member>
      <member><literal>function</literal>: Use function JIT.</member>
     </simplelist>
@@ -1220,6 +1221,12 @@ function getA() { return A; }
      The <literal>"tracing"</literal> mode corresponds to <code>CRTO = 1254</code>,
      the <literal>"function"</literal> mode corresponds to <code>CRTO = 1205</code>.
     </para>
+    <note>
+     <simpara>
+      As of PHP 8.4.0, if the JIT is enabled, PHP exits with a fatal error
+      during startup when JIT initialization fails.
+     </simpara>
+    </note>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.opcache.jit-buffer-size">