[PHP 8.1] Document deprecated ctype non-string argument. (#1179)

Co-authored-by: Christoph M. Becker <[email protected]>

Author: mumumu

appendices/migration81/deprecated.xml

@@ -153,7 +153,7 @@ $arr[] = 2;
     In the future, the argument will be interpreted as a string instead
     of an ASCII codepoint.
     Depending on the intended behavior, the argument should either be
-    casted to &string; or an explicit call to
+    cast to &string; or an explicit call to
     <function>chr</function> should be made.
     All <literal>ctype_*()</literal> functions are affected.
    </para>

language-snippets.ent

@@ -1846,6 +1846,12 @@ the ASCII value of a single character (negative values have 256 added in order t
 characters in the Extended ASCII range). Any other integer is interpreted as a string
 containing the decimal digits of the integer.</para></note>'>
 
+<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
+As of PHP 8.1.0, passing a non-string argument is deprecated.
+In the future, the argument will be interpreted as a string instead of an ASCII codepoint.
+Depending on the intended behavior, the argument should either be cast to &string;
+or an explicit call to <function>chr</function> should be made.</para></warning>'>
+
 <!-- FTP Notes -->
 <!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>

reference/ctype/functions/ctype-alnum.xml

@@ -29,6 +29,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-alpha.xml

@@ -34,6 +34,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-cntrl.xml

@@ -30,6 +30,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-digit.xml

@@ -29,6 +29,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-graph.xml

@@ -29,6 +29,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-lower.xml

@@ -29,6 +29,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-print.xml

@@ -29,6 +29,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>

reference/ctype/functions/ctype-punct.xml

@@ -32,6 +32,7 @@
       <para>
        The tested string.
        &note.ctype.parameter.integer;
+       &note.ctype.parameter.non-string;
       </para>
      </listitem>
     </varlistentry>