ext/pdo: Document PHP 8.5.0 deprecations in PDO constants and methods (#5635)

Author: jordikroon

reference/pdo/constants.xml

@@ -736,6 +736,12 @@
      (<type>int</type>)
     </term>
     <listitem>
+     <warning>
+      <simpara>
+       This constant has been <emphasis>DEPRECATED</emphasis> as of PHP 8.5.0.
+       Use <constant>Pdo\Sqlite::DETERMINISTIC</constant> instead.
+      </simpara>
+     </warning>
      <simpara>
        Specifies that a function created with <methodname>PDO::sqliteCreateFunction</methodname>
        is deterministic, i.e. it always returns the same result given the same inputs within

reference/pdo_firebird/constants.xml

@@ -3,16 +3,23 @@
 <section xml:id="ref.pdo-firebird.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &pdo.driver-constants;
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Firebird</classname>
+   constants instead.
+  </simpara>
+ </warning>
  <variablelist>
   <varlistentry xml:id="pdo.constants.fb-attr-date-format">
    <term>
     <constant>PDO::FB_ATTR_DATE_FORMAT</constant>
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.fb-attr-time-format">
@@ -21,9 +28,9 @@
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_TIME_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.fb-attr-timestamp-format">
@@ -32,9 +39,9 @@
      (<type>int</type>)
    </term>
    <listitem>
-    <para>
+    <simpara>
      &Alias; <constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant>.
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
  </variablelist>

reference/pdo_mysql/constants.xml

@@ -3,6 +3,13 @@
 <section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &pdo.driver-constants;
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Mysql</classname>
+   constants instead.
+  </simpara>
+ </warning>
  <variablelist>
   <varlistentry xml:id="pdo.constants.mysql-attr-use-buffered-query">
    <term>

reference/pdo_odbc/constants.xml

@@ -11,11 +11,22 @@
     (<type>string</type>)
    </term>
    <listitem>
-    <para>
-
-    </para>
+    <simpara>
+     Describes the ODBC library linked against the PDO_ODBC extension.
+     Possible values include <literal>unixODBC</literal>,
+     <literal>iODBC</literal>, or <literal>generic</literal>.
+    </simpara>
    </listitem>
   </varlistentry>
+ </variablelist>
+ <warning>
+  <simpara>
+   The constants listed below have been <emphasis>DEPRECATED</emphasis>
+   as of PHP 8.5.0. Use the corresponding <classname>Pdo\Odbc</classname>
+   constants instead.
+  </simpara>
+ </warning>
+ <variablelist>
   <varlistentry xml:id="pdo.constants.odbc-attr-use-cursor-library">
    <term>
     <constant>PDO::ODBC_ATTR_USE_CURSOR_LIBRARY</constant>

reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml

@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>

reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml

@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>

reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml

@@ -8,6 +8,10 @@
   </refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-5-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>