Update fcd9214 to En

reference/fileinfo/functions/finfo-close.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5b7646656eb183ea568b8261d6d87a10a1b961c7 Maintainer: mch Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: mch Status: ready -->
 <!-- Reviewed: no -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.finfo-close">
  <refnamediv>
@@ -18,7 +18,9 @@
   </methodsynopsis>
 
   <simpara>
-   Функция закрывает экземпляр, который открыли функцией <function>finfo_open</function>.
+   До PHP 7.4 функция закрывала экземпляр, который открыли функцией <function>finfo_open</function>,
+   но с момента преобразования ресурса в объект <classname>finfo</classname> в PHP 8.0 функция перестала выполнять операцию,
+   а с PHP 8.5 функция устарела.
   </simpara>
 
  </refsect1>
@@ -60,7 +62,7 @@
      <row>
       <entry>8.5.0</entry>
       <entry>
-       Теперь тип возвращаемого значения — &true;; ранее был <type>bool</type>.
+       Тип значения возврата изменился на &true;; раньше объявление содержало тип <type>bool</type>.
       </entry>
      </row>
      <row>

reference/ftp/functions/ftp-set-option.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5b7646656eb183ea568b8261d6d87a10a1b961c7 Maintainer: blindman Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: blindman Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.ftp-set-option" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>ftp_set_option</refname>
-  <refpurpose>Устанавливает параметры соединения с FTP-сервером</refpurpose>
+  <refpurpose>Устанавливает параметры работы с FTP-сервером</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -15,7 +15,7 @@
    <methodparam><type class="union"><type>int</type><type>bool</type></type><parameter>value</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция устанавливает параметры соединения с FTP-сервером.
+   Функция управляет параметрами взаимодействия с сервером через активное FTP-соединение.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -32,32 +32,34 @@
      <term><parameter>option</parameter></term>
      <listitem>
       <para>
-       В настоящее время поддерживаются следующие параметры:
+       Параметр поддерживает только следующие опции:
        <table>
-        <title>Поддерживаемые параметры</title>
+        <title>Опции FTP-сеанса</title>
         <tgroup cols="2">
          <tbody>
           <row>
            <entry><constant>FTP_TIMEOUT_SEC</constant></entry>
            <entry>
-            Устанавливает время ожидания сетевых операций, в секундах. Аргумент
-            <parameter>value</parameter> должен быть целым, больше 0. По
-            умолчанию время ожидания равно 90 секундам.
+            Опция изменяет время ожидания в секундах для функций, которые выполняют сетевые операции.
+            Параметр <parameter>value</parameter> принимает для опции только целочисленные значения больше 0.
+            По умолчанию время ожидания равно 90 секундам.
            </entry>
           </row>
           <row>
            <entry><constant>FTP_AUTOSEEK</constant></entry>
-           <entry>При установке этого параметра перед выполнением запросов
-            GET или PUT с параметром <parameter>resumepos</parameter> или
-            <parameter>startpos</parameter> указатель файла будет установлен
-            на запрошенную позицию. Этот параметр установлен по умолчанию.
+           <entry>
+            При включении опции перед выполнением GET-
+            или PUT-запросов с параметром <parameter>resumepos</parameter>
+            или <parameter>startpos</parameter> указатель вначале перемещается
+            на заданную позицию в файле. По умолчанию параметр включён.
            </entry>
           </row>
           <row>
            <entry><constant>FTP_USEPASVADDRESS</constant></entry>
            <entry>
-            Если отключено, то PHP  будет игнорировать IP-адрес, возвращённый сервером в ответ на команду PASV и вместо него будет использовать IP-адрес, переданный в ftp_connect().
-            Параметр <parameter>value</parameter> должен содержать логическое значение.
+            При отключении параметра PHP проигнорирует IP-адрес, который вернул сервер в ответ на команду PASV,
+            и вместо адреса сервера возьмёт IP-адрес хоста, который указали при вызове функции ftp_connect().
+            Параметр <parameter>value</parameter> принимает для опции только логические значения.
            </entry>
           </row>
          </tbody>
@@ -70,21 +72,32 @@
      <term><parameter>value</parameter></term>
      <listitem>
       <para>
-       Назначение этого аргумента зависит от значения параметра
-       <parameter>option</parameter>.
+       Параметр изменяет значение опции,
+       которую указали в параметре <parameter>option</parameter>.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
    &return.true.always;
   </para>
  </refsect1>
 
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   При передаче в параметр <parameter>option</parameter> значения, которое функция не поддерживает,
+   выбрасывается ошибка <exceptionname>ValueError</exceptionname>.
+   Функция выбрасывает ошибку <exceptionname>TypeError</exceptionname>, если в параметр
+   <parameter>value</parameter> передали значение, тип которого не соответствует типу опции в параметре <parameter>option</parameter>.
+  </para>
+ </refsect1>
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -99,7 +112,7 @@
      <row>
       <entry>8.5.0</entry>
       <entry>
-       Теперь тип возвращаемого значения — &true;; ранее был <type>bool</type>.
+       Тип значения возврата изменился на &true;; раньше объявление содержало тип <type>bool</type>.
       </entry>
      </row>
      &ftp.changelog.ftp-param;
@@ -112,13 +125,13 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>ftp_set_option</function></title>
+    <title>Пример установки параметров FTP-сеанса функцией <function>ftp_set_option</function></title>
     <programlisting role="php">
 <![CDATA[
 <?php
-// установка времени ожидания в 10 секунд
+
+// Установка времени сетевого ожидания равного 10 секундам
 ftp_set_option($ftp, FTP_TIMEOUT_SEC, 10);
-?>
 ]]>
       </programlisting>
      </example>

reference/image/functions/imagealphablending.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.imagealphablending" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,21 +11,21 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imagealphablending</methodname>
+   <type>true</type><methodname>imagealphablending</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>bool</type><parameter>enable</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Функция <function>imagealphablending</function> позволяет использовать режим сопряжения
-   цветов для truecolor-изображений при рисовании. В режиме сопряжения альфа
-   компонент цвета, который передаётся всем функциям рисования, вроде
-   <function>imagesetpixel</function>, определяет то, насколько сильно цвет
-   нижележащего слоя будет просачиваться через накладываемое изображение. В
-   результате, gd автоматически сопрягает существующий цвет в каждой точке с цветом
+   Функция <function>imagealphablending</function> устанавливает режим сопряжения
+   цветов для truecolor-изображений при рисовании. В режиме сопряжения альфа-компонент цвета,
+   который передаётся функциям рисования наподобие
+   <function>imagesetpixel</function>, определяет силу просачивания цвета
+   нижележащего слоя через накладываемое изображение.
+   В результате, модуль gd автоматически сопрягает текущий цвет в каждой точке с цветом
    рисуемого поверх изображения и сохраняет результат сопряжения в изображении.
-   Пикселы, подвергшиеся сопряжению, не обладают свойством прозрачности.
-   В режиме без сопряжения цвет рисуемого поверх изображения пиксела буквально
-   копируется вместе со своим альфа компонентом, заменяя пиксел в исходном
+   Сопряжённые пиксели не сохраняют прозрачность.
+   В режиме без сопряжения цвет рисуемого поверх изображения пикселя буквально
+   копируется вместе со своим альфа-компонентом, заменяя пиксель в исходном
    изображении. Режим сопряжения недоступен при рисовании на палитровых
    изображениях.
   </para>
@@ -50,7 +50,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
@@ -74,26 +74,24 @@
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Пример использования <function>imagealphablending</function></title>
+   <title>Пример установки режима сопряжения цветов функцией <function>imagealphablending</function></title>
    <programlisting role="php">
 <![CDATA[
 <?php
 
-// Создание изображения
+// Создаём изображение
 $im = imagecreatetruecolor(100, 100);
 
-// Включение режима сопряжения цветов
+// Включаем режим сопряжения цветов
 imagealphablending($im, true);
 
 // Рисуем прямоугольник
 imagefilledrectangle($im, 30, 30, 70, 70, imagecolorallocate($im, 255, 0, 0));
 
-// Вывод
+// Устанавливаем заголовок с MIME-типом изображения
 header('Content-Type: image/png');
 
 imagepng($im);
-
-?>
 ]]>
    </programlisting>
   </example>

reference/image/functions/imageantialias.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: fcd9214294f88b05862a538c6dd94c7872420139 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.imageantialias" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type>bool</type><methodname>imageantialias</methodname>
+   <type>true</type><methodname>imageantialias</methodname>
    <methodparam><type>GdImage</type><parameter>image</parameter></methodparam>
    <methodparam><type>bool</type><parameter>enable</parameter></methodparam>
   </methodsynopsis>
@@ -19,13 +19,13 @@
    смешивания цветов и работает только с полноцветными truecolor-изображениями.
   </para>
   <para>
-   Стили и толщина не поддерживаются.
+   Для сглаженных примитивов стили и толщина не поддерживаются.
   </para>
   <para>
    Сглаженные примитивы совместно с прозрачным фоном иногда дают
-   неожиданный результат. Метод смешивания использует цвет фона наравне с любым
-   другим цветом. Отсутствие поддержки альфа-компонента не даёт применять
-   основанный на нём метод сглаживания.
+   неожиданный результат. Метод смешивания обрабатывает цвет фона наравне
+   с другими цветами. Отсутствие поддержки альфа-компонента не даёт применять
+   метод сглаживания на основе альфа-канала.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -37,7 +37,7 @@
      <term><parameter>enable</parameter></term>
      <listitem>
       <para>
-       Включить сглаживание или нет.
+       Параметр определяет, включать ли сглаживание.
       </para>
      </listitem>
     </varlistentry>
@@ -47,7 +47,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   &return.success;
+   &return.true.always;
   </para>
  </refsect1>
 
@@ -66,9 +66,8 @@
      <row>
       <entry>7.2.0</entry>
       <entry>
-       Функция <function>imageantialias</function> доступна без ограничений. Ранее она
-       была доступна, только если PHP был собран с использованием библиотеки GD, идущей
-       с ним в комплекте.
+       Функция <function>imageantialias</function> теперь доступна и при сборке PHP с системной библиотекой GD;
+       раньше требовалось компилировать PHP только с библиотекой, которая входит в комплект исходных файлов интерпретатора.
       </entry>
      </row>
     </tbody>
@@ -81,44 +80,39 @@
   <para>
    <example>
     <title>
-     Сравнение двух линий, одна из которых рисуется с включённым сглаживанием
+     Пример сравнения сглаженной и несглаженной линий
     </title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
-// Создание двух изображений
+// Создаём два изображения
 $aa = imagecreatetruecolor(400, 100);
 $normal = imagecreatetruecolor(200, 100);
 
-// Включение сглаживания для одного из них
+// Включаем сглаживание для одного изображения
 imageantialias($aa, true);
 
-// Задание цветов
+// Устанавливаем цвета
 $red = imagecolorallocate($normal, 255, 0, 0);
 $red_aa = imagecolorallocate($aa, 255, 0, 0);
 
-// Рисование линий
+// Рисуем линии
 imageline($normal, 0, 0, 200, 100, $red);
 imageline($aa, 0, 0, 200, 100, $red_aa);
 
-// Размещение изображений рядом для сравнения (АА: слева, Обычное: справа)
+// Объединяем два изображения для вывода: слева — со сглаживанием, справа — без
 imagecopymerge($aa, $normal, 200, 0, 0, 0, 200, 100, 100);
 
-// Вывод результата
+// Устанавливаем заголовок с MIME-типом изображения
 header('Content-type: image/png');
 
 imagepng($aa);
-
-?>
 ]]>
     </programlisting>
     &example.outputs.similar;
     <mediaobject>
-     <alt>
-      Вывод примера: Сравнение двух линий, одна из которых рисуется с
-      включённым сглаживанием
-     </alt>
+     <alt>Вывод примера: изображение с двумя линиями, одна со сглаживанием, другая без сглаживания</alt>
      <imageobject>
       <imagedata fileref="en/reference/image/figures/imageantialias.png"/>
      </imageobject>