Filter: Rewrite INI page (#4146)

Remove personalization, add warning about deprecation

Author: Girgias

reference/filter/ini.xml

@@ -32,11 +32,10 @@
    </tgroup>
   </table>
   &ini.php.constants;
-</para>
+ </para>
 
-&ini.descriptions.title;
+ &ini.descriptions.title;
 
-<para>
  <variablelist>
   <varlistentry xml:id="ini.filter.default">
    <term>
@@ -51,51 +50,52 @@
      Original data can be accessed through <function>filter_input</function>.
     </para>
     <para>
-     Accepts the name of the filter you like to use by default. See the
-     existing <link linkend="filter.filters">filter list</link> for the list
-     of the filter names.
+     Must be the name of a filter which can be determined by using
+     <function>filter_list</function> and <function>filter_id</function>.
     </para>
     <note>
-      <para>
-        Be careful about the default flags for the default filters. You should explicitly 
-        set them to the value you want. For example, to configure the default filter to
-        behave exactly like <function>htmlspecialchars</function> you need to set them
-        default flags to 0 as shown below.
-      </para>
-      <para>
-        <example>
-          <title>Configuring the default filter to act like htmlspecialchars</title>
-          <programlisting role="php">
+     <simpara>
+      Be careful about the default flags for the default filters.
+      They should be set explicitly.
+      For example, to configure the default filter to behave exactly like
+      <function>htmlspecialchars</function> the default flags must be set to
+      <literal>0</literal>, as shown in the example below.
+     </simpara>
+     <example>
+      <title>Configuring the default filter to act like htmlspecialchars</title>
+      <programlisting role="php">
 <![CDATA[
 filter.default = full_special_chars
 filter.default_flags = 0
 ]]>
-          </programlisting>
-        </example>
-      </para>
-   </note>
+      </programlisting>
+     </example>
+    </note>
+    <warning>
+     <simpara>
+      This INI setting is deprecated as of PHP 8.1.0.
+     </simpara>
+    </warning>
    </listitem>
   </varlistentry>
-  
+
   <varlistentry xml:id="ini.filter.default-flags">
    <term>
     <parameter>filter.default_flags</parameter>
     <type>int</type>
    </term>
    <listitem>
-    <para>
-     Default flags to apply when the default filter is set. This is set to 
-     <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant> by default for backwards
-     compatibility reasons.  See the <link linkend="filter.filters.flags">flag list</link>
-     for the list of all the flag names.
-    </para>
+    <simpara>
+     Default flags to apply when the default filter is set.
+     This is set to <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>
+     by default for backwards compatibility reasons.
+     See <constant>FILTER_FLAG_<replaceable>*</replaceable></constant>
+     constants for available flags.
+    </simpara>
    </listitem>
   </varlistentry>
-  
  </variablelist>
- </para>
 </section>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml