svn: /phpdoc/ru/trunk/ appendices/migration80/incompatible.xml reference/errorfunc/functions/set-error-handler.xml reference/json/functions/json-decode.xml reference/mbstring/functions/mb-check-encoding.xml reference/mbstring/functions/mb-chr.xml reference/mbstring/functions/mb-convert-case.xml reference/mbstring/functions/mb-convert-encoding.xml reference/mbstring/functions/mb-convert-kana.xml reference/mbstring/functions/mb-ereg.xml reference/mbstring/functions/mb-eregi-replace.xml reference/m

Modified: phpdoc/ru/trunk/appendices/migration80/incompatible.xml
===================================================================
--- phpdoc/ru/trunk/appendices/migration80/incompatible.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/appendices/migration80/incompatible.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351791 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 352038 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->

 <sect1 xml:id="migration80.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -118,7 +118,8 @@
     </listitem>
     <listitem>
      <para>
-      Аргумент <parameter>errcontext</parameter> для настраиваемых обработчиков ошибок был удален.
+      Аргумент <parameter>errcontext</parameter> больше не передаётся в пользовательские
+      обработчики ошибок, заданных с помощью <function>set_error_handler</function>.
      </para>
     </listitem>
     <listitem>
@@ -1040,8 +1041,9 @@
    </listitem>
    <listitem>
     <para>
-     <function>mb_ereg</function> и <function>mb_eregi</function> теперь будут возвращать логическое значение &true;
-     в случае успешного совпадения. Ранее они возвращали целое число <literal>1</literal>, если
+     <function>mb_ereg</function> и <function>mb_eregi</function> теперь будут возвращать
+     логическое значение &true;, в случае найденого совпадения.
+     Ранее они возвращали целое число <literal>1</literal>, если
      аргумент <parameter>matches</parameter> не был передан, или <code>max(1, strlen($matches[0]))</code>, если
      <parameter>matches</parameter> был не пустой.
     </para>

Modified: phpdoc/ru/trunk/reference/errorfunc/functions/set-error-handler.xml
===================================================================
--- phpdoc/ru/trunk/reference/errorfunc/functions/set-error-handler.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/errorfunc/functions/set-error-handler.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350788 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 352038 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.set-error-handler" xmlns="http://docbook.org/ns/docbook">
@@ -89,7 +89,7 @@
          <term><parameter>errno</parameter></term>
          <listitem>
           <simpara>
-           Первый аргумента <parameter>errno</parameter> содержит уровень
+           В первый аргумент <parameter>errno</parameter> будет передан уровень
            ошибки в виде целого числа.
           </simpara>
          </listitem>
@@ -98,7 +98,7 @@
          <term><parameter>errstr</parameter></term>
          <listitem>
           <simpara>
-           Второй аргумент <parameter>errstr</parameter> содержит сообщение
+           Во второй аргумент <parameter>errstr</parameter> будет передано сообщение
            об ошибке в виде строки.
           </simpara>
          </listitem>
@@ -107,8 +107,9 @@
          <term><parameter>errfile</parameter></term>
          <listitem>
           <simpara>
-           Третий необязательный аргумент <parameter>errfile</parameter>
-           содержит имя файла, в котором произошла ошибка, в виде строки.
+           Если функция обратного вызова принимает третий параметр
+           <parameter>errfile</parameter>, то в него будет передано
+           имя файла, в котором произошла ошибка, в виде строки.
           </simpara>
          </listitem>
         </varlistentry>
@@ -116,8 +117,9 @@
          <term><parameter>errline</parameter></term>
          <listitem>
           <simpara>
-           Четвертый необязательный аргумент <parameter>errline</parameter>
-           содержит номер строки, в которой произошла ошибка, в виде целого
+           Если функция обратного вызова принимает четвёртый параметр
+           <parameter>errline</parameter>, то в него будет передан
+           номер строки, в которой произошла ошибка, в виде целого
            числа.
           </simpara>
          </listitem>
@@ -126,17 +128,20 @@
          <term><parameter>errcontext</parameter></term>
          <listitem>
           <simpara>
-           Пятый необязательный аргумент <parameter>errcontext</parameter>
-           содержит массив указателей на активную таблицу символов в точке, где
+           Если функция обратного вызова принимает пятый параметр
+           <parameter>errcontext</parameter>, то в него будет передан
+           массив указателей на активную таблицу символов в точке, где
            произошла ошибка. Другими словами, <parameter>errcontext</parameter>
            будет содержать массив всех переменных, существующих в области
-           видимости, где произошла ошибка. Пользовательский обработчик не
-           должен изменять этот контекст.
+           видимости, где произошла ошибка. Пользовательские обработчики ошибок не
+           должны изменять этот контекст.
           </simpara>
           <warning xmlns="http://docbook.org/ns/docbook">
            <simpara>
-            Этот параметр объявлен <emphasis>УСТАРЕВШИМ</emphasis> начиная с PHP 7.2.0.
-            Крайне не рекомендуется его использовать.
+            Этот параметр объявлен <emphasis>УСТАРЕВШИМ</emphasis> начиная с PHP 7.2.0 и
+            был <emphasis>УДАЛЁН</emphasis> в PHP 8.0.0. Если в вашей функции этот
+            параметр используется и для него не задано значение по умолчанию, то при
+            вызове функции обработчика будет выдана ошибка "too few arguments".
            </simpara>
           </warning>
          </listitem>
@@ -192,6 +197,13 @@
      </thead>
      <tbody>
       <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Параметр <parameter>errcontext</parameter> был удалён и больше не передаётся в
+        пользовательскую функцию обработки ошибок.
+       </entry>
+      </row>
+      <row>
        <entry>7.2.0</entry>
        <entry>
         Параметр <parameter>errcontext</parameter> объявлен устаревшим. Теперь при его

Modified: phpdoc/ru/trunk/reference/json/functions/json-decode.xml
===================================================================
--- phpdoc/ru/trunk/reference/json/functions/json-decode.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/json/functions/json-decode.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351406 Maintainer: irker Status: ready -->
+<!-- EN-Revision: 352001 Maintainer: irker Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.json-decode" xmlns="http://docbook.org/ns/docbook">
@@ -54,7 +54,7 @@
      <term><parameter>depth</parameter></term>
      <listitem>
       <para>
-       Указывает глубину рекурсии.
+       Максимальная глубина вложенности структуры, для которой будет производиться декодирование.
       </para>
      </listitem>
     </varlistentry>
@@ -85,7 +85,7 @@
    <literal>null</literal> возвращаются как &true;, &false;
    и &null; соответственно. &null; также возвращается, если <parameter>json</parameter>
    не может быть преобразован или закодированные данные содержат вложенных уровней
-   больше, чем допустимый предел для рекурсий.
+   больше, чем указанный предел вложенности.
   </para>
  </refsect1>

@@ -223,7 +223,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// Кодирование данных.
+// Закодируем данные с глубиной вложенности 4 (array -> array -> array -> string).
 $json = json_encode(
     array(
         1 => array(
@@ -239,20 +239,12 @@
     )
 );

-// Создаем массив с ошибками.
-$constants = get_defined_constants(true);
-$json_errors = array();
-foreach ($constants["json"] as $name => $value) {
-    if (!strncmp($name, "JSON_ERROR_", 11)) {
-        $json_errors[$value] = $name;
-    }
-}
+// Напечатаем ошибки для разных глубин.
+var_dump(json_decode($json, true, 4));
+echo 'Последняя ошибка: ', json_last_error_msg(), PHP_EOL, PHP_EOL;

-// Отображаем ошибки для разных глубин рекурсий
-foreach (range(4, 3, -1) as $depth) {
-    var_dump(json_decode($json, true, $depth));
-    echo 'Последняя ошибка: ', $json_errors[json_last_error()], PHP_EOL, PHP_EOL;
-}
+var_dump(json_decode($json, true, 3));
+echo 'Последняя ошибка: ', json_last_error_msg(), PHP_EOL, PHP_EOL;
 ?>
 ]]>
     </programlisting>
@@ -278,10 +270,10 @@
     }
   }
 }
-Последняя ошибка: JSON_ERROR_NONE
+Последняя ошибка: No error

 NULL
-Последняя ошибка: JSON_ERROR_DEPTH
+Последняя ошибка: Maximum stack depth exceeded
 ]]>
     </screen>
    </example>

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-check-encoding.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-check-encoding.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-check-encoding.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 348104 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 352028 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.mb-check-encoding" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -12,12 +12,12 @@
   &reftitle.description;
   <methodsynopsis>
    <type>bool</type><methodname>mb_check_encoding</methodname>
-   <methodparam choice="opt"><type>mixed</type><parameter>var</parameter><initializer>&null;</initializer></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>mb_internal_encoding()</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Проверяет, что для потока данных подходит выбранная кодировка.
-   Если <parameter>var</parameter> является массивом (&array;), все ключи и значения
+   Если <parameter>value</parameter> является массивом (&array;), все ключи и значения
    проверяются рекурсивно.
    Функция может быть полезной для предотвращения так называемой "Атаки
    неправильной кодировкой".
@@ -31,7 +31,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>var</parameter></term>
+     <term><parameter>value</parameter></term>
      <listitem>
       <para>
        Поток данных или массив (&array;) для проверки. Если не задан, функция проверит все входные
@@ -70,9 +70,16 @@
     </thead>
     <tbody>
      <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Параметры <parameter>value</parameter> и <parameter>encoding</parameter> могут
+       принимать значение &null;.
+      </entry>
+     </row>
+     <row>
       <entry>7.2.0</entry>
       <entry>
-       Функция теперь также принимает массив (&array;) в <parameter>var</parameter>.
+       Функция теперь также принимает массив (&array;) в <parameter>value</parameter>.
        Ранее поддерживались только строки (&string;).
       </entry>
      </row>

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-chr.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-chr.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-chr.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 351135 Maintainer: lex Status: ready -->
+<!-- EN-Revision: 352028 Maintainer: lex Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->

 <refentry xml:id="function.mb-chr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -8,27 +8,27 @@
   <refname>mb_chr</refname>
   <refpurpose>Получает определенный символ</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></type><methodname>mb_chr</methodname>
-   <methodparam><type>int</type><parameter>cp</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
+   <methodparam><type>int</type><parameter>codepoint</parameter></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-
+
   </para>
-
+
   &warn.undocumented.func;
-
+
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <variablelist>
    <varlistentry>
-    <term><parameter>cp</parameter></term>
+    <term><parameter>codepoint</parameter></term>
     <listitem>
      <para>

@@ -45,7 +45,7 @@
    </varlistentry>
   </variablelist>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -52,7 +52,24 @@
    Возвращает определенный символ&return.falseforfailure;.
   </para>
  </refsect1>
-
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      &mbstring.changelog.encoding-nullable;
+     </tbody>
+    </tgroup>
+   </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -62,7 +79,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-case.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-case.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-case.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349373 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 352028 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="function.mb-convert-case" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -14,9 +14,9 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>mb_convert_case</methodname>
-   <methodparam><type>string</type><parameter>str</parameter></methodparam>
+   <methodparam><type>string</type><parameter>string</parameter></methodparam>
    <methodparam><type>int</type><parameter>mode</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>mb_internal_encoding()</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
    Производит смену регистра символов в строке (<type>string</type>) в
@@ -29,7 +29,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>str</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Строка (<type>string</type>) для преобразования.

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-encoding.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-encoding.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-encoding.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 348104 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 352035 Maintainer: mch Status: ready -->
 <!-- $Revision$ -->
 <!-- Reviewed: yes -->
 <refentry xml:id="function.mb-convert-encoding" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,17 +11,17 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>mixed</type><methodname>mb_convert_encoding</methodname>
-   <methodparam><type>mixed</type><parameter>val</parameter></methodparam>
+   <type class="union"><type>array</type><type>string</type><type>false</type></type><methodname>mb_convert_encoding</methodname>
+   <methodparam><type class="union"><type>array</type><type>string</type></type><parameter>string</parameter></methodparam>
    <methodparam><type>string</type><parameter>to_encoding</parameter></methodparam>
-   <methodparam choice="opt"><type>mixed</type><parameter>from_encoding</parameter><initializer>mb_internal_encoding()</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>from_encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Преобразует символы <parameter>val</parameter>
+   Преобразует символы <parameter>string</parameter>
    в кодировку <parameter>to_encoding</parameter>.
    Также можно указать необязательный параметр <parameter>from_encoding</parameter>.
-   Если <parameter>val</parameter> является массивом (&array;), все его строковые (&string;) значения будут
-   преобразованы рекурсивно.
+   Если <parameter>string</parameter> является массивом (&array;),
+   все его строковые (&string;) значения будут преобразованы рекурсивно.
   </para>
  </refsect1>

@@ -30,7 +30,7 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>val</parameter></term>
+     <term><parameter>string</parameter></term>
      <listitem>
       <para>
        Строка (&string;) или массив (&array;), для преобразования.
@@ -41,7 +41,7 @@
      <term><parameter>to_encoding</parameter></term>
      <listitem>
       <para>
-       Кодировка, в которую будут преобразованы данные из <parameter>val</parameter>.
+       Кодировка, в которую будут преобразованы данные из <parameter>string</parameter>.
       </para>
      </listitem>
     </varlistentry>
@@ -67,10 +67,39 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Преобразованная строка (&string;) или массив (&array;).
+   Преобразованная строка (&string;) или массив (&array;), &return.falseforfailure;.
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Теперь <parameter>from_encoding</parameter> может быть &null;.
+       </entry>
+      </row>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>7.2.0</entry>
+       <entry>
+        Функция теперь также принимает массив (&array;) в <parameter>string</parameter>.
+        Ранее поддерживались только строки (&string;).
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -106,29 +135,6 @@
   </para>
  </refsect1>

- <refsect1 role="changelog">
-  &reftitle.changelog;
-  <informaltable>
-   <tgroup cols="2">
-    <thead>
-     <row>
-      <entry>&Version;</entry>
-      <entry>&Description;</entry>
-     </row>
-    </thead>
-    <tbody>
-     <row>
-      <entry>7.2.0</entry>
-      <entry>
-       Функция теперь также принимает массив (&array;) в <parameter>val</parameter>.
-       Ранее поддерживались только строки (&string;).
-      </entry>
-     </row>
-    </tbody>
-   </tgroup>
-  </informaltable>
- </refsect1>
-
 </refentry>

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

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-kana.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-kana.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-convert-kana.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -7,7 +7,7 @@
   <refname>mb_convert_kana</refname>
   <refpurpose>Преобразование кодировок "kana" из одной в другую ("zen-kaku", "han-kaku" и другие)</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
@@ -17,11 +17,11 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Поизводит преобразование "han-kaku" - "zen-kaku" для агрумента типа <type>string</type> <parameter>string</parameter>.
+   Поизводит преобразование "han-kaku" - "zen-kaku" для строкового агрумента <parameter>string</parameter>.
    Эта функция может быть полезной только для японского языка.
   </para>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -129,7 +129,7 @@
           <row>
            <entry><literal>c</literal></entry>
            <entry>
-           Преобразование "zen-kaku kata-kana" в "zen-kaku hira-gana"
+            Преобразование "zen-kaku kata-kana" в "zen-kaku hira-gana"
            </entry>
           </row>
           <row>
@@ -183,7 +183,7 @@
    </tgroup>
   </informaltable>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -204,8 +204,9 @@
    </example>
   </para>
  </refsect1>
+
+</refentry>

-</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-ereg.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-ereg.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-ereg.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 340948 Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 352032 Maintainer: northcat Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.mb-ereg" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,10 +11,10 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>int</type><methodname>mb_ereg</methodname>
+   <type>bool</type><methodname>mb_ereg</methodname>
    <methodparam><type>string</type><parameter>pattern</parameter></methodparam>
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
-   <methodparam choice="opt"><type>array</type><parameter role="reference">regs</parameter></methodparam>
+   <methodparam choice="opt"><type>array</type><parameter role="reference">matches</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <simpara>
    Выполняет поиск совпадения с регулярным выражением с поддержкой многобайтовых кодировок.
@@ -42,18 +42,18 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>regs</parameter></term>
+     <term><parameter>matches</parameter></term>
      <listitem>
       <para>
        Если найдены совпадения для подстроки в скобках шаблона <parameter>pattern</parameter>
-       и функция вызвана с третьим аргументом <parameter>regs</parameter>, совпадения
-       будут сохранены в массиве <parameter>regs</parameter>. Если подобных совпадений
-       найдено не будет, то <parameter>regs</parameter> установится как пустой массив.
+       и функция вызвана с третьим аргументом <parameter>matches</parameter>, совпадения
+       будут сохранены в массиве <parameter>matches</parameter>. Если подобных совпадений
+       найдено не будет, то <parameter>matches</parameter> установится как пустой массив.
       </para>
       <para>
-       <varname>$regs[1]</varname> будет содержать первую слева подстроку в скобках;
-       <varname>$regs[2]</varname> - вторую, и так далее.
-       <varname>$regs[0]</varname> будет содержать копию всей строки.
+       <varname>$matches[1]</varname> будет содержать первую слева подстроку в скобках;
+       <varname>$matches[2]</varname> - вторую, и так далее.
+       <varname>$matches[0]</varname> будет содержать копию всей строки.
       </para>
      </listitem>
     </varlistentry>
@@ -64,14 +64,10 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает длину найденной строки в байтах, либо &false;, если совпадений в
-   <parameter>string</parameter> для <parameter>pattern</parameter> не найдено,
-   либо если возникла ошибка.
+   Возвращает &true; или &false;, в зависимости от того, найдено ли совпадение
+   текста по шаблону <parameter>pattern</parameter> в строке
+   <parameter>string</parameter>.
   </para>
-  <para>
-   Если опциональный параметр <parameter>regs</parameter> не задан, либо длина
-   совпавшей строки равна <literal>0</literal>, эта функция вернет <literal>1</literal>.
-  </para>
  </refsect1>

  <refsect1 role="changelog"><!-- {{{ -->
@@ -86,11 +82,23 @@
     </thead>
     <tbody>
      <row>
+      <entry>8.0.0</entry>
+      <entry>
+       Теперь, в случае успешного завершения, эта функция возвращает &true;. Раньше она
+       возвращала длину найденого вхождения <parameter>pattern</parameter> в строке
+       <parameter>string</parameter> в случае, если был передан параметр
+       <parameter>matches</parameter>.
+       Если опциональный параметр <parameter>matches</parameter> не был задан, или
+       длина проверяемой строки равнялясь <literal>0</literal>, эта функция возвращала число
+       <literal>1</literal>.
+      </entry>
+     </row>
+     <row>
       <entry>7.1.0</entry>
       <entry>
-       Теперь <function>mb_ereg</function> устанавливает <parameter>regs</parameter>
+       Теперь <function>mb_ereg</function> устанавливает <parameter>matches</parameter>
        равным пустому массиву (<type>array</type>), если ничего не найдено. Ранее
-       в этом случае <parameter>regs</parameter> оставался неизменным.
+       в этом случае <parameter>matches</parameter> оставался неизменным.
       </entry>
      </row>
     </tbody>

Modified: phpdoc/ru/trunk/reference/mbstring/functions/mb-eregi-replace.xml
===================================================================
--- phpdoc/ru/trunk/reference/mbstring/functions/mb-eregi-replace.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mbstring/functions/mb-eregi-replace.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351730 Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 352028 Maintainer: northcat Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.mb-eregi-replace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -11,11 +11,11 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>string</type><methodname>mb_eregi_replace</methodname>
+   <type class="union"><type>string</type><type>false</type><type>null</type></type><methodname>mb_eregi_replace</methodname>
    <methodparam><type>string</type><parameter>pattern</parameter></methodparam>
-   <methodparam><type>string</type><parameter>replace</parameter></methodparam>
+   <methodparam><type>string</type><parameter>replacement</parameter></methodparam>
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
-   <methodparam choice="opt"><type>string</type><parameter>option</parameter><initializer>"msri"</initializer></methodparam>
+   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <simpara>
    Сканирует строку <parameter>string</parameter> для поиска совпадений с
@@ -37,7 +37,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>replace</parameter></term>
+     <term><parameter>replacement</parameter></term>
      <listitem>
       <para>
        Текст замены.
@@ -53,7 +53,7 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>option</parameter></term>
+     <term><parameter>options</parameter></term>
      <listitem>
       <simpara>
        Опция поиска. Подробнее см. <function>mb_regex_set_options</function>.
@@ -67,7 +67,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Результирующая строка (<type>string</type>) в случае успеха, или &false; в случае ошибки.
+   Результирующая строка (<type>string</type>) в случае успеха, или &false; в случае ошибки.
+   Если <parameter>string</parameter> не является корректной строкой для текущей кодировки,
+   будет возвращено &null;.
   </para>
  </refsect1>

@@ -84,8 +86,21 @@
      </thead>
      <tbody>
       <row>
+       <entry>8.0.0</entry>
+       <entry>
+        Параметр <parameter>options</parameter> теперь может принимать значение &null;.
+       </entry>
+      </row>
+      <row>
        <entry>7.1.0</entry>
        <entry>
+        Функция проверяет, является ли <parameter>string</parameter> корректной строкой для
+        текущей кодировки.
+       </entry>
+      </row>
+      <row>
+       <entry>7.1.0</entry>
+       <entry>
         Модификатор <literal>e</literal> объявлен устаревшим.
        </entry>
       </row>

Modified: phpdoc/ru/trunk/reference/mysqli/mysqli_result/free.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/mysqli_result/free.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mysqli/mysqli_result/free.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350069 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 352045 Maintainer: tmn Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="mysqli-result.free" xmlns="http://docbook.org/ns/docbook">
@@ -12,7 +12,7 @@
    Освобождает память, занятую результатами запроса
   </refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <para>&style.oop;</para>
@@ -36,15 +36,8 @@
   <para>
    Освобождает память, занятую результатами запроса.
   </para>
-  <note>
-   <para>
-    Нужно всегда очищать память функцией
-    <function>mysqli_free_result</function>, если результаты запроса больше не
-    нужны.
-   </para>
-  </note>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -53,7 +46,7 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
@@ -60,19 +53,19 @@
    &return.void;
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
     <member><function>mysqli_query</function></member>
-    <member><function>mysqli_stmt_store_result</function></member>
+    <member><function>mysqli_stmt_get_result</function></member>
     <member><function>mysqli_store_result</function></member>
     <member><function>mysqli_use_result</function></member>
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

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

Modified: phpdoc/ru/trunk/reference/mysqli/mysqli_stmt/construct.xml
===================================================================
--- phpdoc/ru/trunk/reference/mysqli/mysqli_stmt/construct.xml	2020-12-14 07:43:51 UTC (rev 352062)
+++ phpdoc/ru/trunk/reference/mysqli/mysqli_stmt/construct.xml	2020-12-14 08:22:22 UTC (rev 352063)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 350065 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 352044 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->

@@ -8,7 +8,7 @@
   <refname>mysqli_stmt::__construct</refname>
   <refpurpose>Конструктор для объекта <classname>mysqli_stmt</classname></refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <constructorsynopsis>
@@ -19,18 +19,8 @@
   <para>
    Этот метод создает новый объект класса <classname>mysqli_stmt</classname>.
   </para>
-  <note>
-   <para>
-    В общем случае, для создания объекта <classname>mysqli_stmt</classname>,
-    вместо прямого инстанцирования через конструктор (<literal>new mysqli_stmt</literal>),
-    рекомендуется использовать функции <function>mysqli_prepare</function>
-    или <function>mysqli_stmt_init</function>. Этот метод (как и в принципе
-    возможность прямого инстанцирования <classname>mysqli_stmt</classname>)
-    в будущем может быть объявлен устаревшим и удален.
-   </para>
-  </note>
  </refsect1>
-
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -49,7 +39,7 @@
    </variablelist>
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>