svn: /phpdoc/ru/trunk/ language-snippets.ent reference/array/functions/arsort.xml reference/array/functions/asort.xml reference/array/functions/krsort.xml reference/array/functions/ksort.xml reference/array/functions/rsort.xml reference/array/functions/sort.xml reference/ldap/functions/ldap-control-paged-result-response.xml reference/ldap/functions/ldap-control-paged-result.xml reference/spl/arrayobject/asort.xml reference/spl/arrayobject/ksort.xml reference/xmlreader/xmlreader/xml.xml

[email protected] (Sergey Panteleev) Wed, 23 Dec 2020 06:46:35 +0000
Newsgroups php.doc.ru
Message-ID <[email protected]>
sergey                                   Wed, 23 Dec 2020 06:46:35 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=352175

Log:
docs(ru): Updated to English revision

Changed paths:
    U   phpdoc/ru/trunk/language-snippets.ent
    U   phpdoc/ru/trunk/reference/array/functions/arsort.xml
    U   phpdoc/ru/trunk/reference/array/functions/asort.xml
    U   phpdoc/ru/trunk/reference/array/functions/krsort.xml
    U   phpdoc/ru/trunk/reference/array/functions/ksort.xml
    U   phpdoc/ru/trunk/reference/array/functions/rsort.xml
    U   phpdoc/ru/trunk/reference/array/functions/sort.xml
    U   phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result-response.xml
    U   phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result.xml
    U   phpdoc/ru/trunk/reference/spl/arrayobject/asort.xml
    U   phpdoc/ru/trunk/reference/spl/arrayobject/ksort.xml
    U   phpdoc/ru/trunk/reference/xmlreader/xmlreader/xml.xml
svn-diffs-352175.txt (text/x-diff, 18.8 KB)
Modified: phpdoc/ru/trunk/language-snippets.ent
===================================================================
--- phpdoc/ru/trunk/language-snippets.ent	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/language-snippets.ent	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 352143 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->

@@ -357,6 +357,53 @@

 <!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">Сравнение функций сортировки массивов</link>'>

+<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
+  <term><parameter>flags</parameter></term>
+  <listitem>
+   <para>
+    Необязательный второй параметр <parameter>flags</parameter>
+    может использоваться для изменения поведения сортировки с использованием следующих значений:
+   </para>
+   <para>
+    Флаги типа сортировки:
+    <itemizedlist>
+     <listitem>
+      <simpara><constant>SORT_REGULAR</constant> - обычное сравнение элементов;
+      подробности описаны в разделе <link linkend="language.operators.comparison">операторы сравнения</link></simpara>
+     </listitem>
+     <listitem>
+      <simpara><constant>SORT_NUMERIC</constant> - числовое сравнение элементов</simpara>
+     </listitem>
+     <listitem>
+      <simpara><constant>SORT_STRING</constant> - строковое сравнение элементов</simpara>
+     </listitem>
+     <listitem>
+      <simpara>
+       <constant>SORT_LOCALE_STRING</constant> - сравнение элементов как
+       строки на основе текущего языкового стандарта. Используется языковой стандарт,
+       который можно изменить с помощью <function>setlocale</function>
+      </simpara>
+     </listitem>
+     <listitem>
+      <simpara>
+       <constant>SORT_NATURAL</constant> - сравнение элементов как строки,
+       используя "естественный порядок", например <function>natsort</function>
+      </simpara>
+     </listitem>
+     <listitem>
+      <simpara>
+       <constant>SORT_FLAG_CASE</constant> - можно объединять
+       (побитовое ИЛИ) с
+       <constant>SORT_STRING</constant> или
+       <constant>SORT_NATURAL</constant> для сортировки строк без учета регистра
+      </simpara>
+     </listitem>
+    </itemizedlist>
+   </para>
+  </listitem>
+ </varlistentry>
+'>
+
 <!ENTITY avail.register-long-arrays 'Начиная с PHP 5.0.0, длинные <link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">предопределенные переменные</link> массивов PHP могут быть отключены директивой <link xmlns="http://docbook.org/ns/docbook" linkend="ini.register-long-arrays">register_long_arrays</link>.'>

 <!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Если используется <type>int</type>, значение измеряется байтами. Вы также можете использовать сокращенную запись, которая описана в <link linkend="faq.using.shorthandbytes">этом разделе FAQ</link>.</simpara>'>
@@ -732,6 +779,16 @@

 <!-- LDAP notes -->

+<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
+ <simpara>
+  Функция была объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.4.0
+  и <emphasis>УДАЛЕНА</emphasis> в PHP 8.0.0.
+  Вместо нее следует использовать параметр <parameter>controls</parameter> в
+  <function>ldap_search</function>.
+  Смотрите также <link linkend="ldap.controls">Управляющие объекты LDAP</link> для получения дополнительной информации.
+ </simpara>
+</warning>'>
+
 <!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>

Modified: phpdoc/ru/trunk/reference/array/functions/arsort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/arsort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/arsort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.arsort" xmlns="http://docbook.org/ns/docbook">
@@ -36,16 +36,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Вы можете изменить поведение сортировки, используя дополнительный
-       параметр <parameter>flags</parameter>, подробнее
-       см. <function>sort</function>.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/array/functions/asort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/asort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/asort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.asort" xmlns="http://docbook.org/ns/docbook">
@@ -34,16 +34,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Вы можете изменить поведение сортировки, используя
-       дополнительный параметр <parameter>flags</parameter>,
-       подробнее см. <function>sort</function>.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/array/functions/krsort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/krsort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/krsort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.krsort" xmlns="http://docbook.org/ns/docbook">
@@ -31,16 +31,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Вы можете изменить поведение сортировки, используя дополнительный
-       параметр <parameter>flags</parameter>, подробнее
-       см. <function>sort</function>.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/array/functions/ksort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/ksort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/ksort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.ksort" xmlns="http://docbook.org/ns/docbook">
@@ -31,16 +31,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Вы можете изменить поведение сортировки, используя дополнительный
-       параметр <parameter>flags</parameter>, подробнее
-       см. функцию <function>sort</function>.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/array/functions/rsort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/rsort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/rsort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.rsort" xmlns="http://docbook.org/ns/docbook">
@@ -31,16 +31,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Вы можете изменить поведение сортировки, используя дополнительный
-       параметр <parameter>flags</parameter>, подробнее
-       смотрите функцию <function>sort</function>.
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/array/functions/sort.xml
===================================================================
--- phpdoc/ru/trunk/reference/array/functions/sort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/array/functions/sort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351860 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="function.sort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -32,51 +32,7 @@
       </para>
      </listitem>
     </varlistentry>
-    <varlistentry>
-     <term><parameter>flags</parameter></term>
-     <listitem>
-      <para>
-       Дополнительный второй параметр <parameter>flags</parameter>
-       можно использовать для изменения поведения сортировки,
-       используя следующие значения:
-      </para>
-      <para>
-       Флаги сортировки:
-       <itemizedlist>
-        <listitem>
-         <simpara><constant>SORT_REGULAR</constant> - обычное сравнение элементов;
-          подробности описаны в разделе <link linkend="language.operators.comparison">операторы сравнения</link></simpara>
-        </listitem>
-        <listitem>
-         <simpara><constant>SORT_NUMERIC</constant> - числовое сравнение элементов</simpara>
-        </listitem>
-        <listitem>
-         <simpara><constant>SORT_STRING</constant> - строковое сравнение элементов</simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>SORT_LOCALE_STRING</constant> - сравнивает элементы как строки
-          с учетом текущей локали. Используется локаль, которую можно изменять
-          с помощью функции <function>setlocale</function>
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>SORT_NATURAL</constant> - сравнение элементов как строк,
-          используя естественное упорядочение, как в функции <function>natsort</function>
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>SORT_FLAG_CASE</constant> - может быть объединен
-          (побитовое ИЛИ) с
-          <constant>SORT_STRING</constant> или
-          <constant>SORT_NATURAL</constant> для сортировки строк без учета регистра.</simpara>
-        </listitem>
-       </itemizedlist>
-      </para>
-     </listitem>
-    </varlistentry>
+    &sort.flags.parameter;
    </variablelist>
   </para>
  </refsect1>

Modified: phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result-response.xml
===================================================================
--- phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result-response.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result-response.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349064 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 352166 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id='function.ldap-control-paged-result-response'
@@ -11,7 +11,7 @@
  </refnamediv>

  <refsynopsisdiv>
-  &warn.deprecated.function-7-4-0;
+  &ldap.warn.control-paged;
  </refsynopsisdiv>

  <refsect1 role="description">

Modified: phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result.xml
===================================================================
--- phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/ldap/functions/ldap-control-paged-result.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349064 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 352166 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id='function.ldap-control-paged-result'
@@ -11,7 +11,7 @@
  </refnamediv>

  <refsynopsisdiv>
-  &warn.deprecated.function-7-4-0;
+  &ldap.warn.control-paged;
  </refsynopsisdiv>

  <refsect1 role="description">

Modified: phpdoc/ru/trunk/reference/spl/arrayobject/asort.xml
===================================================================
--- phpdoc/ru/trunk/reference/spl/arrayobject/asort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/spl/arrayobject/asort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: aur Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="arrayobject.asort" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>public</modifier> <type>void</type><methodname>ArrayObject::asort</methodname>
-   <void/>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Сортирует элементы массива таким образом, что
@@ -23,7 +23,9 @@

  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <variablelist>
+   &sort.flags.parameter;
+  </variablelist>
  </refsect1>

  <refsect1 role="returnvalues">

Modified: phpdoc/ru/trunk/reference/spl/arrayobject/ksort.xml
===================================================================
--- phpdoc/ru/trunk/reference/spl/arrayobject/ksort.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/spl/arrayobject/ksort.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 334762 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 352168 Maintainer: aur Status: ready -->
 <!-- Reviewed: yes Maintainer: lex -->
 <!-- $Revision$ -->
 <refentry xml:id="arrayobject.ksort" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>public</modifier> <type>void</type><methodname>ArrayObject::ksort</methodname>
-   <void/>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>SORT_REGULAR</constant></initializer></methodparam>
   </methodsynopsis>
   <para>
    Сортирует массив по ключам, сохраняя отношения  между ключами и значениями.
@@ -21,7 +21,9 @@

  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <variablelist>
+   &sort.flags.parameter;
+  </variablelist>
  </refsect1>

  <refsect1 role="returnvalues">

Modified: phpdoc/ru/trunk/reference/xmlreader/xmlreader/xml.xml
===================================================================
--- phpdoc/ru/trunk/reference/xmlreader/xmlreader/xml.xml	2020-12-22 19:38:13 UTC (rev 352174)
+++ phpdoc/ru/trunk/reference/xmlreader/xmlreader/xml.xml	2020-12-23 06:46:35 UTC (rev 352175)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351489 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 352172 Maintainer: mch Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <refentry xml:id="xmlreader.xml" xmlns="http://docbook.org/ns/docbook">
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>bool</type><type>XMLReader</type></type><methodname>XMLReader::XML</methodname>
+   <modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>bool</type><type>XMLReader</type></type><methodname>XMLReader::XML</methodname>
    <methodparam><type>string</type><parameter>source</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>