Update XML documentation for MongoDB methods to enhance clarity and consistency

reference/mongodb/bson/utcdatetimeinterface/tostring.xml

@@ -36,23 +36,23 @@
 
 </refentry>
 
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
+ <!-- Keep this comment at the end of the file
+ Local variables:
+ mode: sgml
+ sgml-omittag:t
+ sgml-shorttag:t
+ sgml-minimize-attributes:nil
+ sgml-always-quote-attributes:t
+ sgml-indent-step:1
+ sgml-indent-data:t
+ indent-tabs-mode:nil
+ sgml-parent-document:nil
+ sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+ sgml-exposed-tags:nil
+ sgml-local-catalogs:nil
+ sgml-local-ecat-files:nil
+ End:
+ vim600: syn=xml fen fdm=syntax fdl=2 si
+ vim: et tw=78 syn=sgml
+ vi: ts=1 sw=1
+ -->

reference/mongodb/mongodb/driver/bulkwritecommandresult/getinsertresults.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.getinsertresults" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::getInsertResults</refname>
-  <refpurpose>Devuelve los resultados detallados de las inserciones exitosas</refpurpose>
+  <refpurpose>Devuelve resultados detallados para las inserciones exitosas</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,13 +13,13 @@
    <modifier>final</modifier> <modifier>public</modifier> <type class="union"><type>MongoDB\BSON\Document</type><type>null</type></type><methodname>MongoDB\Driver\BulkWriteCommandResult::getInsertResults</methodname>
    <void />
   </methodsynopsis>
-  <para>
-   Dado que los campos <literal>_id</literal> de los documentos insertados son generados por
-   la extensión, el valor de <literal>insertedId</literal> en cada resultado
-   corresponderá al valor de retorno de
+  <simpara>
+   Dado que los campos <literal>_id</literal> para los documentos insertados son
+   generados por la extensión, el valor de <literal>insertedId</literal> en cada
+   resultado coincidirá con el valor de retorno de
    <methodname>MongoDB\Driver\BulkWriteCommand::insertOne</methodname> para
    la operación de inserción correspondiente.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -30,12 +29,12 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Devuelve un documento que contiene los resultados de cada operación de inserción
-   o &null; si los resultados detallados no fueron solicitados. Las claves
-   del documento corresponderán al índice de la operación de escritura de
+  <simpara>
+   Devuelve un documento que contiene el resultado de cada operación de inserción
+   exitosa, o &null; si no se solicitaron resultados detallados. Las claves del
+   documento corresponderán al índice de la operación de escritura de
    <classname>MongoDB\Driver\BulkWriteCommand</classname>.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">

reference/mongodb/mongodb/driver/bulkwritecommandresult/getmatchedcount.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.getmatchedcount" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::getMatchedCount</refname>
-  <refpurpose>Devuelve el número de documentos seleccionados para la actualización</refpurpose>
+  <refpurpose>Devuelve el número de documentos seleccionados para actualización</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,12 +13,12 @@
    <modifier>final</modifier> <modifier>public</modifier> <type>int</type><methodname>MongoDB\Driver\BulkWriteCommandResult::getMatchedCount</methodname>
    <void />
   </methodsynopsis>
-  <para>
-   Si la operación de actualización no realiza ningún cambio en el documento (por ejemplo, al
-   definir el valor de un campo a su valor actual), el número de documentos puede ser mayor
-   que el valor devuelto por
+  <simpara>
+   Si la operación de actualización no produce cambios en el documento (por ejemplo,
+   establecer el valor de un campo a su valor actual), el conteo de coincidencias puede ser
+   mayor que el valor devuelto por
    <methodname>MongoDB\Driver\BulkWriteCommandResult::getModifiedCount</methodname>.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -29,9 +28,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Devuelve el número total de documentos seleccionados para la actualización por todas las operaciones.
-  </para>
+  <simpara>
+   Devuelve el número total de documentos seleccionados para actualización por todas las operaciones.
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">

reference/mongodb/mongodb/driver/bulkwritecommandresult/getmodifiedcount.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.getmodifiedcount" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::getModifiedCount</refname>
-  <refpurpose>Devuelve el número de documentos existentes actualizados</refpurpose>
+  <refpurpose>Devuelve el número de documentos existentes que se actualizaron</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,12 +13,12 @@
    <modifier>final</modifier> <modifier>public</modifier> <type>int</type><methodname>MongoDB\Driver\BulkWriteCommandResult::getModifiedCount</methodname>
    <void />
   </methodsynopsis>
-  <para>
-   Si la operación de actualización no realiza ningún cambio en el documento (por ejemplo, al
-   establecer el valor de un campo a su valor actual), el número de documentos puede ser menor
-   que el valor devuelto por
+  <simpara>
+   Si la operación de actualización no produce cambios en el documento (por ejemplo,
+   establecer el valor de un campo a su valor actual), el recuento de documentos
+   modificados puede ser menor que el valor devuelto por
    <methodname>MongoDB\Driver\BulkWriteCommandResult::getMatchedCount</methodname>.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -29,9 +28,10 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Devuelve el número total de documentos existentes actualizados por todas las operaciones.
-  </para>
+  <simpara>
+   Devuelve el número total de documentos existentes que fueron actualizados por
+   todas las operaciones.
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">
@@ -53,6 +53,7 @@
 $manager = new MongoDB\Driver\Manager;
 
 $bulk = new MongoDB\Driver\BulkWriteCommand;
+$bulk->insertOne('db.coll', ['x' => 1]);
 $bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 3]]);
 $bulk->updateOne('db.coll', ['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]);
 $bulk->updateOne('db.coll', ['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]);

reference/mongodb/mongodb/driver/bulkwritecommandresult/getupdateresults.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.getupdateresults" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::getUpdateResults</refname>
-  <refpurpose>Devuelve los resultados detallados de las actualizaciones exitosas</refpurpose>
+  <refpurpose>Devuelve resultados detallados para las actualizaciones exitosas</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,8 +13,8 @@
    <modifier>final</modifier> <modifier>public</modifier> <type class="union"><type>MongoDB\BSON\Document</type><type>null</type></type><methodname>MongoDB\Driver\BulkWriteCommandResult::getUpdateResults</methodname>
    <void />
   </methodsynopsis>
-  <para>
-  </para>
+  <simpara>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -25,12 +24,12 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Devuelve un documento que contiene los resultados de cada operación de actualización
-   exitosa, o &null; si los resultados detallados no fueron solicitados. Las claves
-   del documento corresponderán al índice de la operación de escritura de
+  <simpara>
+   Devuelve un documento que contiene el resultado de cada operación de actualización
+   exitosa, o &null; si no se solicitaron resultados detallados. Las claves del documento
+   corresponderán al índice de la operación de escritura de
    <classname>MongoDB\Driver\BulkWriteCommand</classname>.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">
@@ -113,7 +112,7 @@ object(stdClass)#16 (3) {
       string(1) "0"
     }
     ["upsertedId"]=>
-    object(MongoDB\BSON\ObjectId)#14 (1) {
+    object(MongoDB\BSON\Int64)#14 (1) {
       ["oid"]=>
       string(24) "67f7eb9b1f198bbcb880d576"
     }

reference/mongodb/mongodb/driver/bulkwritecommandresult/getupsertedcount.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.getupsertedcount" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::getUpsertedCount</refname>
-  <refpurpose>Devuelve el número de documentos insertados/actualizados</refpurpose>
+  <refpurpose>Devuelve el número de documentos insertados o actualizados (upserted)</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,8 +13,8 @@
    <modifier>final</modifier> <modifier>public</modifier> <type>int</type><methodname>MongoDB\Driver\BulkWriteCommandResult::getUpsertedCount</methodname>
    <void />
   </methodsynopsis>
-  <para>
-  </para>
+  <simpara>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -25,9 +24,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Devuelve el número total de documentos insertados/actualizados por todas las operaciones.
-  </para>
+  <simpara>
+   Devuelve el número total de documentos insertados o actualizados (upserted) por todas las operaciones.
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">

reference/mongodb/mongodb/driver/bulkwritecommandresult/isacknowledged.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 187032b3ea20fa28f1c9f29ba38d06820428f849 Maintainer: PhilDaiguille Status: ready -->
-<!-- Reviewed: yes -->
-
+<!-- EN-Revision: 9f4cb232d01a06077a2324e38f767d63f87f2e5f Maintainer: PhilDaiguille Status: ready -->
+<!-- Reviewed: no -->
 <refentry xml:id="mongodb-driver-bulkwritecommandresult.isacknowledged" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</refname>
-  <refpurpose>Indica si la escritura fue reconocida</refpurpose>
+  <refpurpose>Devuelve si la escritura fue reconocida</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -14,9 +13,10 @@
    <modifier>final</modifier> <modifier>public</modifier> <type>bool</type><methodname>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</methodname>
    <void />
   </methodsynopsis>
-  <para>
-   Si la escritura fue reconocida, los demás campos estarán disponibles en el objeto <classname>MongoDB\Driver\BulkWriteCommandResult</classname>.
-  </para>
+  <simpara>
+   Si la escritura es reconocida, otros campos estarán disponibles en el
+   objeto <classname>MongoDB\Driver\BulkWriteCommandResult</classname>.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -26,9 +26,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    Devuelve &true; si la escritura fue reconocida, y &false; en caso contrario.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors">
@@ -41,7 +41,7 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title><function>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</function> con escritura reconocida</title>
+   <title><function>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</function> con preocupación de escritura reconocida</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -66,7 +66,7 @@ bool(true)
    </screen>
   </example>
   <example>
-   <title><function>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</function> con escritura no reconocida</title>
+   <title><function>MongoDB\Driver\BulkWriteCommandResult::isAcknowledged</function> con preocupación de escritura no reconocida</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -98,7 +98,7 @@ bool(false)
   &reftitle.seealso;
   <simplelist>
    <member><classname>MongoDB\Driver\WriteConcern</classname></member>
-   <member><link xlink:href="&url.mongodb.docs.writeconcern;">Referencia de Write Concern</link></member>
+   <member><link xlink:href="&url.mongodb.docs.writeconcern;">Referencia de preocupación de escritura</link></member>
   </simplelist>
  </refsect1>