Update e2f2172 to En

language/functions.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dd87866772c31671146ff778140dc0955c55005c Maintainer: sergey Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
  <title>Функции</title>

language/oop5/paamayim-nekudotayim.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: d6f54016d62904cfd8200604aadd5e3f0d9bad97 Maintainer: shein Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="language.oop5.paamayim-nekudotayim" xmlns="http://docbook.org/ns/docbook">
  <title>Оператор разрешения области действия ::</title>
@@ -48,8 +48,6 @@ $classname = 'MyClass';
 echo $classname::CONST_VALUE;
 
 echo MyClass::CONST_VALUE;
-
-?>
 ]]>
   </programlisting>
  </example>
@@ -85,8 +83,6 @@ $classname = 'OtherClass';
 $classname::doubleColon();
 
 OtherClass::doubleColon();
-
-?>
 ]]>
   </programlisting>
  </example>
@@ -128,8 +124,6 @@ class OtherClass extends MyClass
 
 $class = new OtherClass();
 $class->myFunc();
-
-?>
 ]]>
   </programlisting>
  </example>

reference/com/functions/variant-cmp.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 20216b916ed583938672cd09c2c2f430351430d1 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.variant-cmp" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>variant_cmp</refname>
-  <refpurpose>Сравнить два варианта</refpurpose>
+  <refpurpose>Сравнивает два варианта</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -16,10 +16,10 @@
    <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Сравнивает <parameter>left</parameter> с <parameter>right</parameter>.
+   Функция сравнивает значения вариантов в аргументах <parameter>left</parameter> с <parameter>right</parameter>.
   </para>
   <para>
-   Функция сравнивает только скалярные величины. Массивы и записи вариантов не сравнивает.
+   Функция сравнивает только скалярные величины, массивы и записи вариантов не сравниваются.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -46,24 +46,24 @@
      <term><parameter>locale_id</parameter></term>
      <listitem>
       <para>
-       Корректный идентификатор локали, используемый при сравнении строк (влияет на
-       сортировку строк).
+       Допустимый идентификатор локали, который определит
+       правила сопоставления символов при сравнении строк.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>flags</parameter></term>
      <listitem>
       <para>
-       <parameter>flags</parameter> - побитовое ИЛИ следующих значений (либо просто
-       одно из них):
+       Параметр <parameter>flags</parameter> управляет сравнением строк.
+       В аргументе предают отдельные флаги или объединяют флаги побитовым оператором ИЛИ. Доступны следующие значения:
        <table>
         <title>Флаги сравнения вариантов</title>
         <tgroup cols="2">
          <thead>
           <row>
-           <entry>значение</entry>
-           <entry>описание</entry>
+           <entry>Значение</entry>
+           <entry>Описание</entry>
           </row>
          </thead>
          <tbody>
@@ -73,23 +73,23 @@
           </row>
           <row>
            <entry><constant>NORM_IGNORENONSPACE</constant></entry>
-           <entry>Игнорировать символы не занимающие места</entry>
+           <entry>Игнорировать диакритические знаки и другие комбинируемые символы</entry>
           </row>
           <row>
            <entry><constant>NORM_IGNORESYMBOLS</constant></entry>
            <entry>Игнорировать символы</entry>
           </row>
           <row>
            <entry><constant>NORM_IGNOREWIDTH</constant></entry>
-           <entry>Игнорировать длину строки</entry>
+           <entry>Игнорировать разницу между полно- и полуширинными символами</entry>
           </row>
           <row>
            <entry><constant>NORM_IGNOREKANATYPE</constant></entry>
            <entry>Игнорировать тип Кана</entry>
           </row>
           <row>
            <entry><constant>NORM_IGNOREKASHIDA</constant></entry>
-           <entry>Игнорировать символы Кашиды для Арабского языка</entry>
+           <entry>Игнорировать символы Кашиды для арабского языка</entry>
           </row>
          </tbody>
         </tgroup>
@@ -110,33 +110,37 @@
     <tgroup cols="2">
      <thead>
       <row>
-       <entry>значение</entry>
-       <entry>описание</entry>
+       <entry>Значение</entry>
+       <entry>Описание</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><constant>VARCMP_LT</constant></entry>
-       <entry><parameter>left</parameter> меньше чем
-        <parameter>right</parameter>
+       <entry>
+        Значение <parameter>left</parameter> меньше
+        значения <parameter>right</parameter>
        </entry>
       </row>
       <row>
        <entry><constant>VARCMP_EQ</constant></entry>
-       <entry><parameter>left</parameter> идентичен
-        <parameter>right</parameter>
+       <entry>
+        Значение <parameter>left</parameter>
+        равно значению <parameter>right</parameter>
        </entry>
       </row>
       <row>
        <entry><constant>VARCMP_GT</constant></entry>
-       <entry><parameter>left</parameter> больше чем
-        <parameter>right</parameter>
+       <entry>
+        Значение <parameter>left</parameter>
+        больше значения <parameter>right</parameter>
        </entry>
       </row>
       <row>
        <entry><constant>VARCMP_NULL</constant></entry>
-       <entry>Оба значения <parameter>left</parameter> и
-        <parameter>right</parameter> равны &null;
+       <entry>
+        Одно или оба значения <parameter>left</parameter>
+        и <parameter>right</parameter> равны &null;
        </entry>
       </row>
      </tbody>

reference/cubrid/cubridmysql/cubrid-fetch-field.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 22492de2eede0a31a4ac486489d5475e1536354d Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.cubrid-fetch-field">
  <refnamediv>
   <refname>cubrid_fetch_field</refname>
-  <refpurpose>Получает информацию о столбце результирующего набора в виде объекта</refpurpose>
+  <refpurpose>Получает информацию о столбце набора результатов в виде объекта</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -107,7 +107,7 @@
   &reftitle.examples;
   <example>
    <title>
-    Пример использования функции <function>cubrid_fetch_field</function>
+    Пример получения функцией <function>cubrid_fetch_field</function> информации о столбце в наборе результатов
    </title>
    <programlisting role="php">
 <![CDATA[
@@ -139,8 +139,6 @@ printf("%-30s %d\n", "дополняется нулями:", $field->zerofill);
 cubrid_close_request($req);
 
 cubrid_disconnect($conn);
-
-?>
 ]]>
    </programlisting>
    &example.outputs;

reference/datetime/datetimeimmutable/createfromformat.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: f5e51d56b0a4dd7e70dd47ea7eb3c07fdc207ddd Maintainer: shein Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: shein Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="datetimeimmutable.createfromformat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -63,15 +63,15 @@
       символ <literal>d</literal>, для которого метод ищет в строке разбора день месяца,
       принимает значения в диапазоне от <literal>00</literal> до <literal>99</literal>.
       Единственное ограничение — количество цифр.
-      Когда задают значения, которые выходят за пределы диапазона,
+      При установке значения за пределами диапазона
       срабатывает механизм переполнения анализатора даты и времени.
-      Примеры ниже показывают отдельные проявления такого поведения.
+      Примеры показывают поведение при переполнении.
      </para>
      <para>
-      Это также означает, что данные, которые метод анализирует для буквы формата, — жадные,
-      и будут считываться до того количества цифр, которое допускает формат.
-      Иногда это также означает, что в строке <parameter>datetime</parameter> уже не хватает
-      символов для следующих символов формата. Пример на этой странице также иллюстрирует эту проблему.
+      Метод разбирает данные для буквы формата в жадном режиме —
+      считывает предельное для формата количество цифр,
+      поэтому в строке <parameter>datetime</parameter> иногда не остаётся символов
+      для следующих букв формата, и результат становится непредсказуемым. Пример на этой странице также иллюстрирует эту проблему.
      </para>
      <para>
       <table>

reference/dio/functions/dio-open.xml

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: e2f2172bf114599926878017ab2dce356956fa9e Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.dio-open" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dio_open</refname>
   <refpurpose>
-   Открывает файл (по необходимости создаёт) на более низком уровне нежели
-   потоковые функции ввода/вывода языка C
+   Открывает или создаёт файл на уровне ниже,
+   чем потоковые функции ввода-вывода библиотеки языка C
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -18,7 +18,7 @@
    <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   <function>dio_open</function> открывает файл и возвращает его дескриптор.
+   Функция <function>dio_open</function> открывает файл и возвращает файловый дескриптор.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -29,68 +29,68 @@
      <term><parameter>filename</parameter></term>
      <listitem>
       <para>
-       Путь открываемого файла.
+       Путь к файлу, который требуется открыть.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>flags</parameter></term>
      <listitem>
       <para>
-       Параметр <parameter>flags</parameter> задаётся побитовой
-       комбинацией констант. Он <emphasis>должен</emphasis> включать одну из констант
-       <constant>O_RDONLY</constant>, <constant>O_WRONLY</constant>
-       или <constant>O_RDWR</constant>. Дополнительно он может
-       содержать другие константы.
+       Параметр <parameter>flags</parameter> принимает объединённую побитовым оператором ИЛИ
+       комбинацию следующих флагов. В комбинацию <emphasis>обязательно</emphasis> включают
+       константу <constant>O_RDONLY</constant>, <constant>O_WRONLY</constant>
+       или <constant>O_RDWR</constant> и дополнительно указывают
+       произвольную комбинацию других флагов из списка.
        <itemizedlist>
         <listitem>
          <para>
-          <constant>O_RDONLY</constant> - открыть файл на чтение.
+          <constant>O_RDONLY</constant> — открыть файл на чтение.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_WRONLY</constant> - открыть файл на запись.
+          <constant>O_WRONLY</constant> — открыть файл на запись.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_RDWR</constant> - открыть файл на чтение и запись.
+          <constant>O_RDWR</constant> — открыть файл на чтение и запись.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_CREAT</constant> - создать файл, если его не существует.
+          <constant>O_CREAT</constant> — создать файл, если не существует.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_EXCL</constant> - если заданы и <constant>O_CREAT</constant>
-          и <constant>O_EXCL</constant> и файл существует, то
-          <function>dio_open</function> завершится с ошибкой.
+          <constant>O_EXCL</constant> — функция <function>dio_open</function> выдаст ошибку,
+          если установили флаги <constant>O_CREAT</constant>
+          и <constant>O_EXCL</constant>, и файл существует.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_TRUNC</constant> - если файл существует и был открыт на запись, то
-          он будет обрезан до нулевой длины.
+          <constant>O_TRUNC</constant> — при открытии существующего файла на запись
+          функция усечёт файл до нулевой длины.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_APPEND</constant> - операции записи будут происходить в конец файла.
+          <constant>O_APPEND</constant> — запись в конец файла.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_NONBLOCK</constant> - установить неблокирующий режим.
+          <constant>O_NONBLOCK</constant> — установить неблокирующий режим.
          </para>
         </listitem>
         <listitem>
          <para>
-          <constant>O_NOCTTY</constant> - запрещает операционной системе
-          считать открытый файл за терминал контроля процесса, если был открыт
-          файл устройства TTY.
+          <constant>O_NOCTTY</constant> — запрещает операционной системе
+          назначать открытый файл как терминал контроля процесса,
+          если открыли файл устройства TTY.
          </para>
         </listitem>
        </itemizedlist>
@@ -101,15 +101,16 @@
      <term><parameter>mode</parameter></term>
      <listitem>
       <para>
-       Если <parameter>flags</parameter> содержит
-       <constant>O_CREAT</constant>, <parameter>mode</parameter> установит
-       разрешения для файла (creation permissions). <parameter>mode</parameter>
-       требуется для корректной работы в случае указания <constant>O_CREAT</constant>
-       в <parameter>flags</parameter> и в других случаях будет проигнорирован.
+       При передаче в параметр <parameter>flags</parameter>
+       значения <constant>O_CREAT</constant> параметр <parameter>mode</parameter> установит для файла
+       права доступа с учётом системных ограничений на установку прав для вновь создаваемых файлов.
+       Параметр <parameter>mode</parameter> требуется для правильной работы функции
+       при передаче в параметр <parameter>flags</parameter>
+       значения <constant>O_CREAT</constant>, а в остальных случаях игнорируется.
       </para>
       <para>
-       Актуальные разрешения, которые будут присвоены созданному файлу, будут
-       зависеть от настройки <emphasis>umask</emphasis> процесса, как обычно.
+       Фактические разрешения, которые назначаются вновь созданному файлу,
+       стандартно зависят от настройки маски прав доступа <emphasis>umask</emphasis> для процесса.
       </para>
      </listitem>
     </varlistentry>
@@ -119,21 +120,20 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Файловый дескриптор или &false; в случае возникновения ошибки.
+   Функция возвращает дескриптор файла или &false;, если возникла ошибка.
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Открытие файлового дескриптора</title>
+   <title>Пример открытия файлового дескриптора</title>
    <programlisting role="php">
 <![CDATA[
 <?php
 
 $fd = dio_open('/dev/ttyS0', O_RDWR | O_NOCTTY | O_NONBLOCK);
 
 dio_close($fd);
-?>
 ]]>
    </programlisting>
   </example>