diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml
index 1ffeea399538..c3f69617512b 100644
--- a/reference/opcache/ini.xml
+++ b/reference/opcache/ini.xml
@@ -819,7 +819,11 @@
     <listitem>
      <para>
       Enables or disables copying of PHP code (text segment) into HUGE PAGES.
-      This should improve performance, but requires appropriate OS configuration.
+      This should improve performance, but requires appropriate OS configuration
+      to allocate enough HUGE PAGES for the sum of
+      <link linkend="ini.opcache.memory-consumption">opcache.memory_consumption</link>
+      and
+      <link linkend="ini.opcache.jit-buffer-size">opcache.jit_buffer_size</link>.
       Available on Linux as of PHP 7.0.0, and on FreeBSD as of PHP 7.4.0.
      </para>
     </listitem>