From e7df2f8243b91742b8bc2cc92ed8cb5b2cb3c5b2 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 25 May 2026 13:20:10 +0200
Subject: [PATCH 1/2] Fix XML type tags and structure in reference docs

---
 reference/datetime/dateperiod/getdateinterval.xml             | 4 ++--
 reference/ds/ds/deque/map.xml                                 | 2 +-
 reference/ds/ds/sequence/map.xml                              | 2 +-
 reference/hash/functions/hash-init.xml                        | 2 +-
 reference/image/functions/imagecrop.xml                       | 1 +
 reference/imagick/imagick/getimagehistogram.xml               | 3 +--
 reference/info/functions/assert-options.xml                   | 1 +
 reference/memcached/memcached/getserverlist.xml               | 2 +-
 reference/memcached/memcached/increment.xml                   | 2 +-
 reference/mongodb/mongodb/driver/exception/writeexception.xml | 2 ++
 reference/mysql/functions/mysql-list-tables.xml               | 2 +-
 reference/mysqlnd/stats.xml                                   | 1 +
 reference/reflection/reflectionclass/getextensionname.xml     | 2 +-
 reference/reflection/reflectionmethod/getdeclaringclass.xml   | 2 +-
 reference/snmp/snmp/getnext.xml                               | 2 +-
 reference/spl/splfileinfo/openfile.xml                        | 2 +-
 16 files changed, 18 insertions(+), 14 deletions(-)

diff --git a/reference/datetime/dateperiod/getdateinterval.xml b/reference/datetime/dateperiod/getdateinterval.xml
index e4c6b08f1..d9c515a89 100644
--- a/reference/datetime/dateperiod/getdateinterval.xml
+++ b/reference/datetime/dateperiod/getdateinterval.xml
@@ -18,7 +18,7 @@
    <void/>
   </methodsynopsis>
   <para>
-   Devuelve un <type>objeto</type> <classname>DateInterval</classname> que representa el intervalo utilizado para el período.
+   Devuelve un <classname>DateInterval</classname> <type>object</type> que representa el intervalo utilizado para el período.
   </para>
  </refsect1>
 
@@ -30,7 +30,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Devuelve un <type>objeto</type> <classname>DateInterval</classname>
+   Devuelve un <classname>DateInterval</classname> <type>object</type>
   </para>
  </refsect1>
 
diff --git a/reference/ds/ds/deque/map.xml b/reference/ds/ds/deque/map.xml
index 2a0b45bb0..877fff1f1 100644
--- a/reference/ds/ds/deque/map.xml
+++ b/reference/ds/ds/deque/map.xml
@@ -34,7 +34,7 @@
              </methodsynopsis>
          </para>
          <para>
-            Una <type>retrollamada</type> a aplicar a cada valor de la deque.
+            Una <type>callable</type> a aplicar a cada valor de la deque.
          </para>
 
          <para>
diff --git a/reference/ds/ds/sequence/map.xml b/reference/ds/ds/sequence/map.xml
index 272db40e9..2a13099b2 100644
--- a/reference/ds/ds/sequence/map.xml
+++ b/reference/ds/ds/sequence/map.xml
@@ -34,7 +34,7 @@
              </methodsynopsis>
          </para>
          <para>
-            Una <type>retrollamada</type> a aplicar a cada valor de la deque.
+            Una <type>callable</type> a aplicar a cada valor de la deque.
          </para>
 
          <para>
diff --git a/reference/hash/functions/hash-init.xml b/reference/hash/functions/hash-init.xml
index 1f7bcbe1a..2b300da0a 100644
--- a/reference/hash/functions/hash-init.xml
+++ b/reference/hash/functions/hash-init.xml
@@ -61,7 +61,7 @@
      <listitem>
       <para>
        Un array de opciones para los algoritmos diversos de hachado.
-       Actualmente, solo el parámetro <parameter>"seed"</parameter> es
+       Actualmente, solo el parámetro <literal>"seed"</literal> es
        soportado para las variantes MurmurHash.
       </para>
      </listitem>
diff --git a/reference/image/functions/imagecrop.xml b/reference/image/functions/imagecrop.xml
index 6fb922f8d..7961a5b51 100644
--- a/reference/image/functions/imagecrop.xml
+++ b/reference/image/functions/imagecrop.xml
@@ -57,6 +57,7 @@
      </row>
     </thead>
     <tbody>
+     &gd.changelog.image-param;
      <row>
       <entry>8.0.0</entry>
       <entry>
diff --git a/reference/imagick/imagick/getimagehistogram.xml b/reference/imagick/imagick/getimagehistogram.xml
index ca6e13be1..3762118d6 100644
--- a/reference/imagick/imagick/getimagehistogram.xml
+++ b/reference/imagick/imagick/getimagehistogram.xml
@@ -29,8 +29,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Devuelve un array de objetos ImagickPixel.
-   &imagick.imagickexception.throw;
+   Devuelve un array de objetos <classname>ImagickPixel</classname>.
   </para>
  </refsect1>
 
diff --git a/reference/info/functions/assert-options.xml b/reference/info/functions/assert-options.xml
index 1de8ff8c6..7e188ddc8 100644
--- a/reference/info/functions/assert-options.xml
+++ b/reference/info/functions/assert-options.xml
@@ -162,6 +162,7 @@
      </listitem>
     </varlistentry>
    </variablelist>
+   Pasar una cadena vacía como <parameter>value</parameter> restablece la función de retrollamada assert.
   </para>
  </refsect1>
 
diff --git a/reference/memcached/memcached/getserverlist.xml b/reference/memcached/memcached/getserverlist.xml
index d0215cc9b..3a36bcbbc 100644
--- a/reference/memcached/memcached/getserverlist.xml
+++ b/reference/memcached/memcached/getserverlist.xml
@@ -36,7 +36,7 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Ejemplo con <function>Memcached::getResultCode</function></title>
+    <title>Ejemplo con <function>Memcached::getServerList</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
diff --git a/reference/memcached/memcached/increment.xml b/reference/memcached/memcached/increment.xml
index fb6dfb7c3..58c1471e2 100644
--- a/reference/memcached/memcached/increment.xml
+++ b/reference/memcached/memcached/increment.xml
@@ -77,7 +77,7 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Ejemplo con <function>Memcached::getResultCode</function></title>
+    <title>Ejemplo con <function>Memcached::increment</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
diff --git a/reference/mongodb/mongodb/driver/exception/writeexception.xml b/reference/mongodb/mongodb/driver/exception/writeexception.xml
index a7fe6df37..8786285f2 100644
--- a/reference/mongodb/mongodb/driver/exception/writeexception.xml
+++ b/reference/mongodb/mongodb/driver/exception/writeexception.xml
@@ -39,6 +39,7 @@
     <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <ooclass>
+      <modifier>abstract</modifier>
       <classname>MongoDB\Driver\Exception\WriteException</classname>
      </ooclass>
 
@@ -107,6 +108,7 @@
        </row>
       </thead>
       <tbody>
+       &mongodb.changelog.class-removed;
        <row>
         <entry>PECL mongodb 1.20.0</entry>
         <entry>
diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml
index a918caeef..c12a98384 100644
--- a/reference/mysql/functions/mysql-list-tables.xml
+++ b/reference/mysql/functions/mysql-list-tables.xml
@@ -52,7 +52,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Un recurso de punteros de resultados en caso de éxito&return.falseforfailure;.
+   Un recurso de punteros de resultados <type>resource</type> en caso de éxito&return.falseforfailure;.
   </simpara>
   <simpara>
    Utilice la función <function>mysql_tablename</function>
diff --git a/reference/mysqlnd/stats.xml b/reference/mysqlnd/stats.xml
index 4b7e986ce..1953ace60 100644
--- a/reference/mysqlnd/stats.xml
+++ b/reference/mysqlnd/stats.xml
@@ -1123,6 +1123,7 @@ $res->close();
       El número total de columnas de tipo
       <literal>MYSQL_TYPE_TINY_BLOB</literal>,
       <literal>MYSQL_TYPE_MEDIUM_BLOB</literal>,
+      <literal>MYSQL_TYPE_LONG_BLOB</literal>,
       o <literal>MYSQL_TYPE_BLOB</literal>
       recuperadas desde una consulta normal (protocolo de texto MySQL).
      </simpara>
diff --git a/reference/reflection/reflectionclass/getextensionname.xml b/reference/reflection/reflectionclass/getextensionname.xml
index f3f4d93fc..36cfa1eac 100644
--- a/reference/reflection/reflectionclass/getextensionname.xml
+++ b/reference/reflection/reflectionclass/getextensionname.xml
@@ -10,7 +10,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis role="ReflectionClass">
-   <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>ReflectionFunctionAbstract::getExtensionName</methodname>
+   <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>ReflectionClass::getExtensionName</methodname>
    <void/>
   </methodsynopsis>
   <para>
diff --git a/reference/reflection/reflectionmethod/getdeclaringclass.xml b/reference/reflection/reflectionmethod/getdeclaringclass.xml
index c4ca2e312..5be9751cb 100644
--- a/reference/reflection/reflectionmethod/getdeclaringclass.xml
+++ b/reference/reflection/reflectionmethod/getdeclaringclass.xml
@@ -16,7 +16,7 @@
   <para>
    Obtiene la declaración de la clase del método reflejado
   </para>
-</refsect1>
+ </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
diff --git a/reference/snmp/snmp/getnext.xml b/reference/snmp/snmp/getnext.xml
index ed4c07144..48edaff99 100644
--- a/reference/snmp/snmp/getnext.xml
+++ b/reference/snmp/snmp/getnext.xml
@@ -24,7 +24,7 @@
   &reftitle.parameters;
   <simpara>
    Si <parameter>objectId</parameter> es una &string;, entonces
-   <methodname>SNMP::get</methodname> devolverá un objeto
+   <methodname>SNMP::getnext</methodname> devolverá un objeto
    <acronym>SNMP</acronym> en forma de &string;.
    Si <parameter>objectId</parameter> es un array, todos los
    objetos <acronym>SNMP</acronym> solicitados serán devueltos en forma de
diff --git a/reference/spl/splfileinfo/openfile.xml b/reference/spl/splfileinfo/openfile.xml
index 736a48f73..88b8253a0 100644
--- a/reference/spl/splfileinfo/openfile.xml
+++ b/reference/spl/splfileinfo/openfile.xml
@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Crea un <type>object</type> <classname>SplFileObject</classname> de
+   Crea un <classname>SplFileObject</classname> <type>object</type> de
    el fichero. Esto es útil porque <classname>SplFileObject</classname>
    contiene otros métodos para manipular el fichero mientras que
    <classname>SplFileInfo</classname> sólo es útil para obtener información,

From 93fc1689f637b5ceaad73d82f8c7975f724a2264 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Mon, 25 May 2026 13:27:58 +0200
Subject: [PATCH 2/2] Review fix: avoid redundant resource wording in
 mysql_list_tables return value

---
 reference/mysql/functions/mysql-list-tables.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/mysql/functions/mysql-list-tables.xml b/reference/mysql/functions/mysql-list-tables.xml
index c12a98384..ce70336f2 100644
--- a/reference/mysql/functions/mysql-list-tables.xml
+++ b/reference/mysql/functions/mysql-list-tables.xml
@@ -52,7 +52,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Un recurso de punteros de resultados <type>resource</type> en caso de éxito&return.falseforfailure;.
+   Un puntero de resultados <type>resource</type> en caso de éxito&return.falseforfailure;.
   </simpara>
   <simpara>
    Utilice la función <function>mysql_tablename</function>