[Sync-En] pdo: revert constant types to int and document the getAttribute() bool change

reference/pdo/constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: Marqitos Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: Marqitos Status: ready -->
 <!-- Reviewed: no -->
 <appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -230,16 +230,12 @@
    <varlistentry xml:id="pdo.constants.attr-autocommit">
     <term>
      <constant>PDO::ATTR_AUTOCOMMIT</constant>
-     (<type>bool</type>)
+     (<type>int</type>)
     </term>
     <listitem>
      <simpara>
       Si el valor es &false;, PDO intenta desactivar la validación automática
-      cuando la conexión comienza una transacción.
-     </simpara>
-     <simpara>
-      A partir de PHP 8.4.0 esta constante es de tipo <type>bool</type>;
-      anteriormente, era de tipo <type>int</type>.
+      para que la conexión inicie una transacción.
      </simpara>
     </listitem>
    </varlistentry>
@@ -443,10 +439,10 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     </term>
     <listitem>
      <simpara>
-      Añade el contenido del catálogo de nombres en cada nombre de columna devuelto en el
-      conjunto de resultados. El catálogo de nombres y los nombres de columnas están separados por
+      Antepone el nombre del catálogo que lo contiene a cada nombre de columna devuelto en el
+      conjunto de resultados. El nombre del catálogo y el nombre de la columna están separados por
       un punto (.). El soporte de este atributo es a nivel de controlador; puede no
-      estar disponible por el controlador en uso.
+      estar disponible en el controlador en uso.
      </simpara>
     </listitem>
    </varlistentry>
@@ -457,10 +453,10 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     </term>
     <listitem>
      <simpara>
-      Añade el contenido de la tabla de nombres en cada nombre de columna devuelto en el
-      conjunto de resultados. La tabla de nombres y los nombres de columnas están separados por
+      Antepone el nombre de la tabla que lo contiene a cada nombre de columna devuelto en el
+      conjunto de resultados. El nombre de la tabla y el nombre de la columna están separados por
       un punto (.). El soporte de este atributo es a nivel de controlador; puede no
-      estar disponible por el controlador en uso.
+      estar disponible en el controlador en uso.
      </simpara>
     </listitem>
    </varlistentry>
@@ -471,7 +467,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     </term>
     <listitem>
      <simpara>
-      Fuerza todas las valores recuperados (excepto &null;) a ser tratados como strings.
+      Fuerza todos los valores recuperados (excepto &null;) a ser tratados como strings.
       Los valores &null; permanecen sin cambios, a menos que <constant>PDO::ATTR_ORACLE_NULLS</constant>
       esté definido en <constant>PDO::NULL_TO_STRING</constant>.
      </simpara>
@@ -502,7 +498,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
    <varlistentry xml:id="pdo.constants.attr-emulate-prepares">
     <term>
      <constant>PDO::ATTR_EMULATE_PREPARES</constant>
-     (<type>bool</type>)
+     (<type>int</type>)
     </term>
     <listitem>
      <simpara>
@@ -512,10 +508,6 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
       &true;, PDO siempre emula las sentencias preparadas; cuando se define a
       &false;, utiliza las sentencias preparadas nativas del controlador.
      </simpara>
-     <simpara>
-      A partir de PHP 8.4.0 esta constante es de tipo <type>bool</type>;
-      anteriormente, era de tipo <type>int</type>.
-     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo.constants.attr-default-str-param">
@@ -570,6 +562,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     <listitem>
      <simpara>
       Lanza una excepción <classname>PDOException</classname> si ocurre un error.
+      Este es el modo predeterminado a partir de PHP 8.0.0.
       Ver los <link linkend="pdo.error-handling">errores y la gestión de errores</link>
       para más información sobre este atributo.
      </simpara>
@@ -666,7 +659,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     </term>
     <listitem>
      <simpara>
-      Asigna un evento
+      Evento de asignación
      </simpara>
     </listitem>
    </varlistentry>
@@ -677,7 +670,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
     </term>
     <listitem>
      <simpara>
-      Elimina un evento
+      Evento de liberación
      </simpara>
     </listitem>
    </varlistentry>
@@ -750,7 +743,7 @@ if ($db->getAttribute(PDO::ATTR_DRIVER_NAME) == 'mysql') {
       </simpara>
      </warning>
      <simpara>
-      Especifica que una función creada con <methodname>PDO::PDO::sqliteCreateFunction</methodname>
+      Especifica que una función creada con <methodname>PDO::sqliteCreateFunction</methodname>
       es determinista, es decir, siempre devuelve el mismo resultado
       por las mismas entradas en una sola instrucción SQL. (Disponible a partir de PHP 7.1.4.)
      </simpara>

reference/pdo/pdo/getattribute.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9c73659a3578fa34561e7e6531f98c4eaac4c990 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="pdo.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -94,6 +94,17 @@
        <constant>PDO::ATTR_STRINGIFY_FETCHES</constant>.
       </entry>
      </row>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       El valor de <constant>PDO::ATTR_AUTOCOMMIT</constant> ahora es devuelto
+       como <type>bool</type> por los controladores de MySQL y Firebird, y el
+       valor de <constant>PDO::ATTR_EMULATE_PREPARES</constant> y de
+       <constant>PDO::MYSQL_ATTR_DIRECT_QUERY</constant> ahora es devuelto como
+       <type>bool</type> por el controlador de MySQL; anteriormente, se
+       devolvían como <type>int</type>.
+      </entry>
+     </row>
     </tbody>
    </tgroup>
   </informaltable>

reference/pdo_dblib/pdo-dblib.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5d8e96f9b174f7471daebce760657eb0f190b0ba Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: lacatoire Status: ready -->
 <!-- Reviewed: yes -->
 <reference xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.pdo-dblib" role="class">
  <title>La clase Pdo\Dblib</title>
@@ -34,9 +34,7 @@
      </ooclass>
 
      <classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
-      <xi:fallback/>
-     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))"/>
 
      <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
      <fieldsynopsis>
@@ -54,7 +52,7 @@
      <fieldsynopsis>
       <modifier>public</modifier>
       <modifier>const</modifier>
-      <type>bool</type>
+      <type>int</type>
       <varname linkend="pdo-dblib.constants.attr-stringify-uniqueidentifier">Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</varname>
      </fieldsynopsis>
      <fieldsynopsis>
@@ -78,17 +76,13 @@
      <fieldsynopsis>
       <modifier>public</modifier>
       <modifier>const</modifier>
-      <type>bool</type>
+      <type>int</type>
       <varname linkend="pdo-dblib.constants.attr-datetime-convert">Pdo\Dblib::ATTR_DATETIME_CONVERT</varname>
      </fieldsynopsis>
 
      <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])">
-      <xi:fallback/>
-     </xi:include>
-     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])">
-      <xi:fallback/>
-     </xi:include>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])"/>
+     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])"/>
     </classsynopsis>
    </packagesynopsis>
    <!-- }}} -->
@@ -116,8 +110,6 @@
      <term><constant>Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant></term>
      <listitem>
       <simpara>
-       A partir de PHP 8.4.0 esta constante es de tipo <type>bool</type>;
-       anteriormente, era de tipo <type>int</type>.
       </simpara>
      </listitem>
     </varlistentry>
@@ -155,10 +147,6 @@
        el archivo <filename>locales.conf</filename> de FreeTDS. Por defecto,
        este atributo es &false;.
       </simpara>
-      <simpara>
-       A partir de PHP 8.4.0 esta constante es de tipo <type>bool</type>;
-       anteriormente, era de tipo <type>int</type>.
-      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>

reference/pdo_mysql/constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 00b118595a963f00211e96224e3fba35bdebc83c Maintainer: PhilDaiguille Status: ready -->
 <section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
  &pdo.driver-constants;
@@ -92,16 +92,12 @@
   <varlistentry xml:id="pdo.constants.mysql-attr-direct-query">
    <term>
     <constant>PDO::MYSQL_ATTR_DIRECT_QUERY</constant>
-    (<type>bool</type>)
+    (<type>int</type>)
    </term>
    <listitem>
     <simpara>
      &Alias; <constant>PDO::ATTR_EMULATE_PREPARES</constant>
     </simpara>
-    <simpara>
-     A partir de PHP 8.4.0 esta constante es de tipo <type>bool</type>;
-     anteriormente, era de tipo <type>int</type>.
-    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="pdo.constants.mysql-attr-found-rows">