diff --git a/appendices/ini.xml b/appendices/ini.xml
index 6b89f10f34..38b6c3dad4 100644
--- a/appendices/ini.xml
+++ b/appendices/ini.xml
@@ -3951,6 +3951,8 @@ auto_prepend_file=security.php
        <para>
         Check for BOM (Byte Order Mark) and see if the file contains valid
         multibyte characters.
+        This detection is performed before processing of
+        <function>__halt_compiler</function>.
         Available only in Zend Multibyte mode.
        </para>
       </listitem>