[DOC-CVS] [doc-en] master: ini/display_errors: Improve impossible values (#5486)

Author: Jordi Kroon (jordikroon)
Date: 2026-05-17T21:56:20+02:00

Commit: https://github.com/php/doc-en/commit/e5ff446c832aded712d45c885609ffdd277e6a49
Raw diff: https://github.com/php/doc-en/commit/e5ff446c832aded712d45c885609ffdd277e6a49.diff

ini/display_errors: Improve impossible values (#5486)

Changed paths:
  M  reference/errorfunc/ini.xml


Diff:

diff --git a/reference/errorfunc/ini.xml b/reference/errorfunc/ini.xml
index a2adb57ff1c6..b0dfb357bf4a 100644
--- a/reference/errorfunc/ini.xml
+++ b/reference/errorfunc/ini.xml
@@ -197,7 +197,6 @@
      </note>
     </listitem>
    </varlistentry>
-
    <varlistentry xml:id="ini.display-errors">
     <term>
      <parameter>display_errors</parameter>
@@ -207,39 +206,34 @@
      <para>
       This determines whether errors should be printed to the screen
       as part of the output or if they should be hidden from the user.
+      <itemizedlist>
+       <listitem>
+        <simpara>
+         <literal>Off</literal> - do not display any errors.
+        </simpara>
+       </listitem>
+       <listitem>
+        <simpara>
+         <literal>On</literal> or <literal>stdout</literal> - display errors to <literal>stdout</literal>. This is the default.
+        </simpara>
+       </listitem>
+       <listitem>
+        <simpara>
+         <literal>stderr</literal> - display errors to <literal>stderr</literal>. Only effective for the <literal>CLI</literal>, <literal>phpdbg</literal> and <literal>CGI</literal> SAPIs.
+        </simpara>
+       </listitem>
+      </itemizedlist>
      </para>
-     <para>
-       Possible Values:
-     </para>
-     <itemizedlist>
-         <listitem>
-           <para>Off = Do not display any errors</para>
-         </listitem>
-         <listitem>
-          <para>stderr = Display errors to <literal>STDERR</literal> (affects only CGI/CLI binaries!)</para>
-          </listitem>
-         <listitem>
-          <para> On or stdout = Display errors to <literal>STDOUT</literal></para>
-         </listitem>
-         <listitem>
-          <para> Default Value: On</para>
-         </listitem>
-         <listitem>
-          <para>Development Value: On</para>
-         </listitem>
-         <listitem>
-           <para>Production Value: Off</para>
-         </listitem>
-       </itemizedlist>
-     <para>
-      Value <literal>"stderr"</literal> sends the errors to <literal>stderr</literal>
-      instead of <literal>stdout</literal>.
-     </para>
+     <simpara>
+       The bundled <literal>php.ini-development</literal> sets this to
+       <literal>On</literal>; <literal>php.ini-production</literal> sets
+       it to <literal>Off</literal>.
+     </simpara>
      <note>
-      <para>
+      <simpara>
       This is a feature to support your development and should never be used 
       on production systems (e.g. systems connected to the internet).
-      </para>
+      </simpara>
      </note>
      <note>
       <para>