Обновление до английской версии (#586)

Co-authored-by: Sergey Panteleev <sergey@php.net>

reference/mysql_xdevapi/mysql_xdevapi/collectionfind/execute.xml

@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 730ae1c76c5312b00b284d36fe42436e1cdbcae2 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ee52285714f7f7371364a3e5233d2ca2da078706 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysql-xdevapi-collectionfind.execute" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>CollectionFind::execute</refname>
@@ -28,15 +27,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Объект DocResult, из которого можно получить результаты
+   Возвращает объект класса <classname>mysql_xdevapi\DocResult</classname>, из которого можно
-   или запросить состояние операции.
+   либо получить результаты, либо запросить состояние операции.
   </para>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример использования CollectionFind</title>
+   <title>Пример использования класса CollectionFind</title>
    <programlisting role="php">
 <![CDATA[
 <?php

reference/mysql_xdevapi/mysql_xdevapi/collectionfind/fields.xml

@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 730ae1c76c5312b00b284d36fe42436e1cdbcae2 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ee52285714f7f7371364a3e5233d2ca2da078706 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysql-xdevapi-collectionfind.fields" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>CollectionFind::fields</refname>
@@ -15,7 +14,7 @@
    <methodparam><type>string</type><parameter>projection</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Определяет столбцы для запроса, которые нужно вернуть. Если не определено,
+   Определяет столбцы, которые должен вернуть запрос. Если не определено,
    то возвращаются все столбцы.
   </para>
 
@@ -28,8 +27,8 @@
     <term><parameter>projection</parameter></term>
     <listitem>
      <para>
-      Может быть одной строкой или массивом строк, эти строки определяют столбцы,
+      Может быть либо одной строкой, либо массивом строк, определяющих столбцы,
-      которые должны быть возвращены для каждого документа, соответствующего условию поиска.
+      которые нужно вернуть для каждого документа, который соответствует условию поиска.
      </para>
     </listitem>
    </varlistentry>
@@ -39,7 +38,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Объект CollectionFind, который можно использовать для дальнейшей обработки.
+   Возвращает объект класса CollectionFind, который можно использовать для дальнейшей обработки.
   </para>
  </refsect1>
 

reference/mysql_xdevapi/mysql_xdevapi/collectionfind/groupby.xml

@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 730ae1c76c5312b00b284d36fe42436e1cdbcae2 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ee52285714f7f7371364a3e5233d2ca2da078706 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysql-xdevapi-collectionfind.groupby" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>CollectionFind::groupBy</refname>
@@ -15,8 +14,9 @@
    <methodparam><type>string</type><parameter>sort_expr</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Функция может использоваться для группировки набора результатов по ещё одному столбцу, часто это используется с
+   Эту функцию вызывают для группировки набора результатов по одному или нескольким столбцам.
-   агрегатными функциями, такими как COUNT,MAX,MIN,SUM и т.д.
+   Её часто вызывают с агрегатными функциями, например: <literal>COUNT</literal>,
+   <literal>MAX</literal>, <literal>MIN</literal>, <literal>SUM</literal> и т. д.
   </para>
 
  </refsect1>
@@ -28,7 +28,7 @@
     <term><parameter>sort_expr</parameter></term>
     <listitem>
      <para>
-      Столбец или столбцы, которые должны использоваться для операции группировки, это может быть либо одна строка,
+      Столбец или столбцы, по которым будет проведена операция группировки, это может быть либо одна строка,
       либо массив строковых аргументов, по одному для каждого столбца.
      </para>
     </listitem>
@@ -39,21 +39,21 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Объект CollectionFind, который можно использовать для дальнейшей обработки.
+   Возвращает объект класса CollectionFind, с которым можно будет работать далее.
   </para>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример использования <function>mysql_xdevapi\CollectionFind::groupBy</function></title>
+   <title>Пример использования метода <function>mysql_xdevapi\CollectionFind::groupBy</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
 
-//Предполагая, что $coll является корректным объектом Collection
+// Предполагая, что $coll — корректный объект класса Collection
 
-//Извлекает все документы из коллекции и группирует результаты по полю 'name'
+// Извлекает все документы из коллекции и группирует результаты по полю 'name'
 $res = $coll->find()->groupBy('name')->execute();
 
 ?>
@@ -62,7 +62,6 @@ $res = $coll->find()->groupBy('name')->execute();
   </example>
  </refsect1>
 
-
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:

reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockexclusive.xml

@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ee52285714f7f7371364a3e5233d2ca2da078706 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysql-xdevapi-collectionfind.lockexclusive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>CollectionFind::lockExclusive</refname>
@@ -15,13 +14,18 @@
    <methodparam choice="opt"><type>int</type><parameter>lock_waiting_option</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Блокирует исключительно документ, другие транзакции блокируются с момента обновления документа и до тех пор, пока документ заблокирован.
+   Накладывает на документ исключительную блокировку. До тех пор, пока документ заблокирован,
-   Пока документ заблокирован, другие транзакции не могут обновлять эти документы, выполнять SELECT ... LOCK IN SHARE MODE
+   другие транзакции не могут обновлять документ,
-   или читать данные на определённых уровнях изоляции транзакций. Последовательные чтения игнорируют любые блокировки, установленные для записей,
+   выполнять выражения <code>SELECT ... LOCK IN SHARE MODE</code>
+   или читать данные на отдельных уровнях изоляции транзакций.
+   Согласованные чтения игнорируют любые блокировки, установленные для записей,
    которые существуют в представлении чтения.
    </para>
   <para>
-   Функция полезна непосредственно с командой modify(), чтобы избежать проблем параллелизма. По сути, она сериализует доступ к строке через блокировку строки.
+   Чтобы не было проблем с конкурентным доступом,
+   имеет ссмысл вызывать этот метод совместно с методом
+   <methodname>mysql_xdevapi\Collection::modify</methodname>.
+   По существу, эта функция использует блокировки строк для сериализации доступа к строкам.
   </para>
  </refsect1>
 
@@ -32,8 +36,8 @@
     <term><parameter>lock_waiting_option</parameter></term>
     <listitem>
      <para>
-      Дополнительная опция ожидания. По умолчанию имеет значение <constant>MYSQLX_LOCK_DEFAULT</constant>.
+      Дополнительная опция ожидания. Значение по умолчанию — <constant>MYSQLX_LOCK_DEFAULT</constant>.
-      Допустимые значения представлены константами:
+      Допустимые значения определены константами:
      </para>
      <itemizedlist>
       <listitem><para><constant>MYSQLX_LOCK_DEFAULT</constant></para></listitem>
@@ -48,14 +52,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает объект CollectionFind, который можно использовать для дальнейшей обработки.
+   Возвращает объект класса CollectionFind, с которым можно будет работать далее.
   </para>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример использования <function>mysql_xdevapi\CollectionFind::lockExclusive</function></title>
+   <title>Пример использования метода <function>mysql_xdevapi\CollectionFind::lockExclusive</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php

reference/mysql_xdevapi/mysql_xdevapi/collectionfind/lockshared.xml

@@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: sergey Status: ready -->
+<!-- EN-Revision: ee52285714f7f7371364a3e5233d2ca2da078706 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
-
 <refentry xml:id="mysql-xdevapi-collectionfind.lockshared" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>CollectionFind::lockShared</refname>
@@ -15,16 +14,14 @@
    <methodparam choice="opt"><type>int</type><parameter>lock_waiting_option</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Позволяет разделять документы между несколькими транзакциями, которые блокируются в режиме совместного использования.
+   Разрешает разделять документы между несколькими транзакциями, которые блокируются в режиме совместного доступа.
   </para>
   <para>
    Другие сеансы могут читать строки, но не могут изменять их, пока ваша транзакция не будет зафиксирована.
   </para>
   <para>
-   Если какая-либо из этих строк была изменена другой транзакцией, которая ещё не зафиксирована,
+   Если какая-то из этих строк была изменена другой транзакцией, которая ещё не зафиксирована,
-  </para>
+   запрос подождёт завершения этой транзакции, а затем использует зафиксированные значения.
-  <para>
-   ваш запрос подождёт завершения этой транзакции, а затем использует самые последние значения.
   </para>
 
  </refsect1>
@@ -52,14 +49,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Объект CollectionFind, который можно использовать для дальнейшей обработки
+   Возвращает объект класса CollectionFind, с которым можно будет работать далее.
   </para>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример использования <function>mysql_xdevapi\CollectionFind::lockShared</function></title>
+   <title>Пример использования метода <function>mysql_xdevapi\CollectionFind::lockShared</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -75,7 +72,7 @@ $result = $collection
   ->lockShared()
   ->execute();
 
-// ... читаем объект в режиме совместного использования
+// ... читаем объект в режиме совместного доступа
 
 // Завершаем транзакцию и разблокируем документ
 $session->commit();