svn: /phpdoc/ru/trunk/reference/mongodb/ bson/objectid.xml mongodb/driver/cursor.xml

Modified: phpdoc/ru/trunk/reference/mongodb/bson/objectid.xml
===================================================================
--- phpdoc/ru/trunk/reference/mongodb/bson/objectid.xml	2019-09-05 06:18:51 UTC (rev 347943)
+++ phpdoc/ru/trunk/reference/mongodb/bson/objectid.xml	2019-09-05 07:01:06 UTC (rev 347944)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 344505 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 347928 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->

 <phpdoc:classref xml:id="class.mongodb-bson-objectid" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -21,8 +21,7 @@
    </para>
    <itemizedlist>
     <listitem><simpara>4-байтовое значение, представляющее секунды с начала эпохи Unix,</simpara></listitem>
-    <listitem><simpara>3-байтовый идентификатор машины,</simpara></listitem>
-    <listitem><simpara>2-байтовый идентификатор процесса и</simpara></listitem>
+    <listitem><simpara>5-байтовое случайное число, уникальное для машины и процесса, и</simpara></listitem>
     <listitem><simpara>3-байтовый счетчик, начинающийся со случайного значения.</simpara></listitem>
    </itemizedlist>
    <para>

Modified: phpdoc/ru/trunk/reference/mongodb/mongodb/driver/cursor.xml
===================================================================
--- phpdoc/ru/trunk/reference/mongodb/mongodb/driver/cursor.xml	2019-09-05 06:18:51 UTC (rev 347943)
+++ phpdoc/ru/trunk/reference/mongodb/mongodb/driver/cursor.xml	2019-09-05 07:01:06 UTC (rev 347944)
@@ -1,16 +1,16 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 344505 Maintainer: lex Status: ready -->
+<!-- EN-Revision: 347931 Maintainer: lex Status: ready -->
 <!-- Reviewed: no -->

 <phpdoc:classref xml:id="class.mongodb-driver-cursor" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
-
+
  <title>Класс MongoDB\Driver\Cursor</title>
  <titleabbrev>MongoDB\Driver\Cursor</titleabbrev>
-
+
  <partintro>
-
-<!-- {{{ MongoDB\Driver\Cursor intro -->
+
+  <!-- {{{ MongoDB\Driver\Cursor intro -->
   <section xml:id="mongodb-driver-cursor.intro">
    &reftitle.intro;
    <para>
@@ -20,16 +20,16 @@
     <methodname>MongoDB\Driver\Manager::executeQuery</methodname> соответственно.
    </para>
   </section>
-<!-- }}} -->
-
+  <!-- }}} -->
+
   <section xml:id="mongodb-driver-cursor.synopsis">
    &reftitle.classsynopsis;
-
-<!-- {{{ Synopsis -->
+
+   <!-- {{{ Synopsis -->
    <classsynopsis>
     <ooclass><classname>MongoDB\Driver\Cursor</classname></ooclass>
-
-<!-- {{{ Class synopsis -->
+
+    <!-- {{{ Class synopsis -->
     <classsynopsisinfo>
      <modifier>final</modifier>
      <ooclass>
@@ -40,32 +40,56 @@
       <interfacename>Traversable</interfacename>
      </oointerface>
     </classsynopsisinfo>
-<!-- }}} -->
+    <!-- }}} -->

     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.mongodb-driver-cursor')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
    </classsynopsis>
-<!-- }}} -->
-
+   <!-- }}} -->
+
   </section>

-    <section xml:id="mongodb-driver-cursor.examples">
+  <section role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>1.6.0</entry>
+        <entry>
+         Реализует <interfacename>MongoDB\Driver\CursorInterface</interfacename>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </section>
+
+  <section xml:id="mongodb-driver-cursor.examples">
    &reftitle.examples;
-
-   <example xml:id="mongodb-driver-cursor.examples.foreach">
-    <title>Reading a result set</title>
-    <para>
-     Как <methodname>MongoDB\Driver\Manager::executeCommand</methodname>, так
-     <methodname>MongoDB\Driver\Manager::executeQuery</methodname>, возвращают
-     свои результаты в виде объекта <classname>MongoDB\Driver\Cursor</classname>.
-    </para>
-    <para>
-     Поскольку <classname>MongoDB\Driver\Cursor</classname> реализует интерфейс
-     <interfacename>Traversable</interfacename>, вы можете
-     итерировать по набору результата с помощью
-     <link linkend="control-structures.foreach"><literal>foreach</literal></link>.
-    </para>
-   <programlisting role="php">
+
+     <example xml:id="mongodb-driver-cursor.examples.foreach">
+      <title>Reading a result set</title>
+      <para>
+       Как <methodname>MongoDB\Driver\Manager::executeCommand</methodname>, так
+       <methodname>MongoDB\Driver\Manager::executeQuery</methodname>, возвращают
+       свои результаты в виде объекта <classname>MongoDB\Driver\Cursor</classname>.
+      </para>
+      <para>
+       Поскольку <classname>MongoDB\Driver\Cursor</classname> реализует интерфейс
+       <interfacename>Traversable</interfacename>, вы можете
+       итерировать по набору результата с помощью
+       <link linkend="control-structures.foreach"><literal>foreach</literal></link>.
+      </para>
+      <programlisting role="php">
 <![CDATA[
 <?php

@@ -91,9 +115,9 @@

 ?>
 ]]>
-   </programlisting>
-   &example.outputs.similar;
-   <screen>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
 <![CDATA[
 stdClass Object
 (
@@ -119,41 +143,41 @@
 }
 ]]>
     </screen>
-   </example>
-
-   <example xml:id="mongodb-driver-cursor.examples.tailable">
-    <title>Чтение набора результатов для хвостового курсора</title>
-    <para>
-     <link xlink:href="&url.mongodb.docs;core/tailable-cursors">Хвостовые курсоры</link> -
-     - это особый тип курсора MongoDB, который позволяет клиенту читать некоторые результаты,
-     а затем ждать, пока не появятся дополнительные документы.
-     Эти курсоры в основном используются с
-     <link xlink:href="&url.mongodb.docs;core/capped-collections">Capped Collections</link>
-     and <link xlink:href="&url.mongodb.docs;changeStreams">Change Streams</link>.
-    </para>
-    <para>
-     Хотя обычные курсоры можно итерировать один раз с помощью <literal>foreach</literal>,
-     этот подход не будет работать с хвостовыми курсорами.
-     Когда <literal>foreach</literal> используется с хвостовым курсором,
-     цикл останавливается по достижении конца начального набора результатов.
-     Попытка продолжить итерацию курсора со вторым <literal>foreach</literal> выбросить исключение,
-     поскольку PHP пытается перемотать курсор. Подобно объектам результатов в других драйверах баз данных,
-     курсоры в MongoDB поддерживают только итерацию вперед, что означает, что они не могут быть перемотаны.
-    </para>
-    <para>
-     Для непрерывного считывания с хвостового курсора объект курсора должен быть завернут
-     с помощью <classname>IteratorIterator</classname>. Это позволяет приложению напрямую управлять
-     итерацией курсора, избегать непреднамеренного перемотки курсора и решать, когда ждать новых результатов
-     или полностью прекратить итерацию.
-    </para>
-    <para>
-     Чтобы продемонстрировать хвостовой курсор в действии,
-     будут использоваться два скрипта: "производитель" (producer) и "потребитель" (consumer).
-     Скрипт продюсера создаст новую capped-коллекцию, используя команду
-     <link xlink:href="&url.mongodb.docs.command;create">create</link>
-     и начнет вставку нового документа в эту коллекцию каждую секунду.
-    </para>
-    <programlisting role="php">
+     </example>
+
+     <example xml:id="mongodb-driver-cursor.examples.tailable">
+      <title>Чтение набора результатов для хвостового курсора</title>
+      <para>
+       <link xlink:href="&url.mongodb.docs;core/tailable-cursors">Хвостовые курсоры</link> -
+       - это особый тип курсора MongoDB, который позволяет клиенту читать некоторые результаты,
+       а затем ждать, пока не появятся дополнительные документы.
+       Эти курсоры в основном используются с
+       <link xlink:href="&url.mongodb.docs;core/capped-collections">Capped Collections</link>
+       and <link xlink:href="&url.mongodb.docs;changeStreams">Change Streams</link>.
+      </para>
+      <para>
+       Хотя обычные курсоры можно итерировать один раз с помощью <literal>foreach</literal>,
+       этот подход не будет работать с хвостовыми курсорами.
+       Когда <literal>foreach</literal> используется с хвостовым курсором,
+       цикл останавливается по достижении конца начального набора результатов.
+       Попытка продолжить итерацию курсора со вторым <literal>foreach</literal> выбросить исключение,
+       поскольку PHP пытается перемотать курсор. Подобно объектам результатов в других драйверах баз данных,
+       курсоры в MongoDB поддерживают только итерацию вперед, что означает, что они не могут быть перемотаны.
+      </para>
+      <para>
+       Для непрерывного считывания с хвостового курсора объект курсора должен быть завернут
+       с помощью <classname>IteratorIterator</classname>. Это позволяет приложению напрямую управлять
+       итерацией курсора, избегать непреднамеренного перемотки курсора и решать, когда ждать новых результатов
+       или полностью прекратить итерацию.
+      </para>
+      <para>
+       Чтобы продемонстрировать хвостовой курсор в действии,
+       будут использоваться два скрипта: "производитель" (producer) и "потребитель" (consumer).
+       Скрипт продюсера создаст новую capped-коллекцию, используя команду
+       <link xlink:href="&url.mongodb.docs.command;create">create</link>
+       и начнет вставку нового документа в эту коллекцию каждую секунду.
+      </para>
+      <programlisting role="php">
 <![CDATA[
 <?php

@@ -232,9 +256,9 @@
       чтобы указать время, которое сервер должен блокировать, когда он достигнет конца набора результатов.
      </simpara>
     </note>
-   </example>
+     </example>
   </section>
-
+
   <section role="errors">
    &reftitle.errors;
    <simpara>
@@ -251,11 +275,11 @@
     &mongodb.throws.bson.unexpected;
    </simplelist>
   </section>
-
+
  </partintro>
-
+
  &reference.mongodb.mongodb.driver.entities.cursor;
-
+
 </phpdoc:classref>

 <!-- Keep this comment at the end of the file