Обновление до английской версии

Closes #1040
2025-07-22 18:26:31 +00:00 · 2025-02-12 12:00:08 +03:00
parent 192030da23
commit 6e2f527dc7
6 changed files with 104 additions and 75 deletions
--- a/language-snippets.ent
+++ b/language-snippets.ent
@ -1026,16 +1026,16 @@ $compareFunc = static function ($item1, $item2) {
 устарела и сохранилась только из-за обратной совместимости.
 Функцию не рекомендуют использовать, поскольку не исключают риск удаления функции из PHP в будущем.</simpara>'>

-<!ENTITY ext.windows.path.dll 'Чтобы модуль работал, системной переменной
-<envar xmlns="http://docbook.org/ns/docbook">PATH</envar>, которую содержит операционная система Windows,
-дают доступ к <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-файлам.
+<!ENTITY ext.windows.path.dll 'Модуль работает в ОС Windows,
+только когда системной переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>
+доступны <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-файлы.
 Раздел <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym>
-«<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Как добавить директорию PHP в переменную PATH в Windows</link>»
+«<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Как добавить PHP-каталог в переменную PATH в Windows</link>»
 рассказывает, как это сделать. Не рекомендуют копировать DLL-файлы
-из директории PHP в системную папку Windows, хотя это также решает проблему (потому что системная
-директория по умолчанию записана в переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>).
-<emphasis xmlns="http://docbook.org/ns/docbook">Модулю нужны
-следующие файлы в переменной <envar>PATH</envar>:</emphasis> '>
+из директории PHP в системную папку Windows, хотя это тоже решает проблему, поскольку системная
+переменная <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> содержит путь к системной директории по умолчанию.
+<emphasis xmlns="http://docbook.org/ns/docbook">Для работы модуля
+в переменной <envar>PATH</envar> потребуются следующие файлы:</emphasis> '>

 <!ENTITY manual.migration.seealso 'Смотрите также руководство по миграции для версий PHP'>

@ -3000,8 +3000,8 @@ xmlns="http://docbook.org/ns/docbook"><term>
 <!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Функция доступна,
 только если модуль fann собрали для модуля libfann &gt;= 2.2.</para></note>'>

-<!ENTITY stream.bucket.param 'Параметр <parameter>bucket</parameter> теперь ожидает экземпляр класса <classname>StreamBucket</classname>; ранее ожидался объект <classname>stdClass</classname>.'>
-<!ENTITY stream.bucket.return 'Функция теперь возвращает объект класса <classname>StreamBucket</classname>; ранее возвращался объект <classname>stdClass</classname>.'>
+<!ENTITY stream.bucket.param 'Параметр <parameter>bucket</parameter> теперь ожидает экземпляр класса <classname>StreamBucket</classname>; раньше ожидался объект <classname>stdClass</classname>.'>
+<!ENTITY stream.bucket.return 'Функция теперь возвращает объект класса <classname>StreamBucket</classname>; раньше возвращался объект <classname>stdClass</classname>.'>

 <!-- Imagick generic return types -->
 <!ENTITY imagick.return.success 'Функция в случае успешной работы возвращает &true;.'>
--- a/reference/imap/book.xml
+++ b/reference/imap/book.xml
@ -4,7 +4,7 @@
 <!-- State: deprecated -->
 <book xml:id="book.imap" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="pecl" ?>
- <title>IMAP, POP3 и NNTP</title>
+ <title>Протоколы IMAP, POP3 и NNTP</title>
 <titleabbrev>IMAP</titleabbrev>

 <!-- {{{ preface -->
@ -12,20 +12,20 @@
  &reftitle.intro;
  <warning>
   <simpara>
-    Модуль объявлен <emphasis>УСТАРЕВШИМ</emphasis> и <emphasis>НЕ ДОСТУПЕН</emphasis> с PHP 8.4.0.
+    Модуль <emphasis>УСТАРЕЛ</emphasis>, а начиная с PHP 8.4.0 модуль <emphasis>УДАЛИЛИ</emphasis> из сборки.
   </simpara>
  </warning>
  <para>
-   Эти функции позволяют работать с
-   протоколом <acronym>IMAP</acronym>, а также <acronym>NNTP</acronym>, <acronym>POP3</acronym>
+   Функции модуля помогают работать
+   с протоколом <acronym>IMAP</acronym>, а также с протоколами <acronym>NNTP</acronym>, <acronym>POP3</acronym>
   и локальными методами доступа к почтовому ящику.
  </para>
  <para>
-   Однако следует иметь в виду, что некоторые функции IMAP не будут корректно работать c протоколом POP.
+   Обратите внимание, отдельные функции модуля IMAP неправильно работают c протоколом POP.
  </para>
  <warning>
   <simpara>
-    Модуль IMAP не является потокобезопасным; его не следует использовать со сборками ZTS.
+    Модуль IMAP непотокобезопасен; его лучше не использовать с ZTS-сборками.
   </simpara>
  </warning>
 </preface>
--- a/reference/imap/configure.xml
+++ b/reference/imap/configure.xml
@ -1,34 +1,47 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: fc870e6f972ed48069f4c7a5a449c2e843f343a7 Maintainer: irker Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: irker Status: ready -->
 <!-- Reviewed: no -->
-<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook">
+<section xml:id="imap.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
- <para>
-  Чтобы включить поддержку IMAP в сборку PHP, добавьте в конфигурацию опцию
-  <option role="configure">--with-imap[=DIR]</option>, где DIR это
-  папка установки c-client. Для нашего вышеуказанного примера вы должны использовать
-  <option role="configure">--with-imap=/usr/local/imap-2000b</option>.
-  Этот путь зависит от того, где вы создали эту директорию в соответствии с
-  описанием выше. <productname>Windows</productname> пользователи могут подключить
-  <filename>php_imap.dll</filename> DLL в &php.ini;.
- </para>
- <note>
-  <simpara>
-   В зависимости от того как настроен ваш c-client, вам может понадобиться
-   добавить <option
-   role="configure">--with-imap-ssl=/path/to/openssl/</option> и/или
-   <option role="configure">--with-kerberos=/path/to/kerberos</option>
-   ключ при конфигурировании PHP.
-  </simpara>
- </note>
+ <section xml:id="imap.installation.php84">
+  <title>PHP 8.4</title>
+  <para>
+   &pecl.moved-ver;8.4.0
+  </para>
+  <para>
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;imap">&url.pecl.package;imap</link>.
+  </para>
+ </section>

- <warning>
-  <simpara>
-   Модуль IMAP не является потокобезопасным; его не следует использовать со сборками ZTS.
-  </simpara>
- </warning>
+ <section xml:id="imap.installation.phplt84">
+  <title>PHP &lt; 8.4</title>
+  <para>
+   Функции модуля работают, только если PHP скомпилировали с параметром
+   <option role="configure">--with-imap[=DIR]</option>, где DIR —
+   папка с установленной библиотекой c-client. Для приведённого примера потребуется указать
+   <option role="configure">--with-imap=/usr/local/imap-2000b</option>.
+   Точный путь зависит от каталога для исходного кода, который создавали
+   на предыдущем шаге. Пользователи ОС <productname>Windows</productname> подключают
+   DLL-файл <filename>php_imap.dll</filename> в файле &php.ini;.
+  </para>
+  <note>
+   <simpara>
+    В зависимости от настроек библиотеки c-client
+    в строку конфигурации PHP иногда требуется
+    добавить ключ <option role="configure">--with-imap-ssl=/path/to/openssl/</option>
+    и (или) <option role="configure">--with-kerberos=/path/to/kerberos</option>.
+   </simpara>
+  </note>

- &warn.imaprecodeyaz;
+  <warning>
+   <simpara>
+    Модуль IMAP непотокобезопасен; его лучше не использовать с ZTS-сборками.
+   </simpara>
+  </warning>
+
+  &warn.imaprecodeyaz;
+ </section>

 </section>
 <!-- Keep this comment at the end of the file
--- a/reference/imap/setup.xml
+++ b/reference/imap/setup.xml
@ -1,7 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: irker Status: ready -->
 <!-- Reviewed: no -->
-
 <chapter xml:id="imap.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

@ -9,24 +8,24 @@
 <section xml:id="imap.requirements">
  &reftitle.required;
  <para>
-   Модуль требует установленной библиотеки c-client.
+   Модуль работает только с установленной библиотекой c-client.
   Возьмите последнюю версию с <link xlink:href="&url.imap;">&url.imap;</link>
   и скомпилируйте её.
  </para>
  <para>
-   Важно не копировать исходные файлы IMAP непосредственно в
-   системный каталог include, поскольку это может вызвать конфликт.
-   Вместо этого создайте каталог внутри системного каталога с каталогом include,
-   например <filename>/usr/local/imap-2000b/</filename> (расположение и имя
-   зависят от настроек и версии IMAP), и внутри этого нового каталога
+   Важно не копировать исходные файлы модуля IMAP непосредственно
+   в системный каталог include, поскольку иногда это вызывает конфликт.
+   Вместо этого создайте новый каталог внутри системного каталога с путём наподобие
+   <filename>/usr/local/imap-2000b/</filename>. Точное расположение и название
+   каталога зависят от настроек и версии модуля IMAP. Затем внутри этого нового каталога
   создайте дополнительные каталоги с именами <filename>lib/</filename>
   и <filename>include/</filename>. Из каталога библиотеки <filename>c-client</filename>,
-   который лежит внутри дерева исходных файлов IMAP, скопируйте файлы <filename>*.h</filename>
+   который лежит внутри дерева исходных файлов модуля IMAP, скопируйте файлы с расширением <filename>*.h</filename>
   в каталог <filename>include/</filename>, а файлы
-   <filename>*.c</filename> — в каталог <filename>lib/</filename>.
+   с расширением <filename>*.c</filename> — в каталог <filename>lib/</filename>.
   Кроме того, при компиляции IMAP создаётся файл с именем
-   <filename>c-client.a</filename>. Переименуйте этот файл в
-   <filename>libc-client.a</filename> и скопируйте его в каталог <filename>lib/</filename>.
+   <filename>c-client.a</filename>. Переименуйте этот файл
+   в <filename>libc-client.a</filename> и скопируйте его в каталог <filename>lib/</filename>.
  </para>
  <note>
   <para>
@ -36,10 +35,10 @@
  </note>
  <note>
   <simpara>
-    В Mandrake Linux библиотека IMAP (<filename>libc-client.a</filename>)
+    В дистрибутиве Mandrake Linux библиотека IMAP (файл <filename>libc-client.a</filename>)
    компилируется без поддержки протокола Kerberos. Версия с поддержкой протокола SSL
-    (<filename>client-PHP4.a</filename>) устанавливается отдельно.
-    Чтобы добавить поддержку Kerberos, перекомпилируйте библиотеку.
+    (файл <filename>client-PHP4.a</filename>) устанавливается отдельно.
+    Библиотеку перекомпилируют, чтобы добавить поддержку сетевого протокола Kerberos.
   </simpara>
  </note>
 </section>
@ -57,8 +56,8 @@
 <section xml:id="imap.resources">
  &reftitle.resources;
  <simpara>
-   До PHP 8.1.0, ресурс <literal>imap</literal>, возвращаемый функцией
-   <function>imap_open</function>, ссылался на открытый поток IMAP.
+   До PHP 8.1.0 модуль определял тип ресурса <literal>imap</literal>, который возвращает функция
+   <function>imap_open</function> и который ссылался на открытый IMAP-поток.
  </simpara>
 </section>
 <!-- }}} -->
--- a/reference/pspell/book.xml
+++ b/reference/pspell/book.xml
@ -1,16 +1,20 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 81b23db050ac0627b056585c16bfe95445ae174e Maintainer: northcat Status: ready -->
+<!-- EN-Revision: 86177fa035acc7fdb972855bdd6c0b19edd505cd Maintainer: northcat Status: ready -->
 <!-- Reviewed: no -->
-
 <book xml:id="book.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <?phpdoc extension-membership="bundledexternal" ?>
+ <?phpdoc extension-membership="pecl" ?>
 <title>Pspell</title>

 <!-- {{{ preface -->
 <preface xml:id="intro.pspell">
  &reftitle.intro;
+  <warning>
+   <simpara>
+    Модуль <emphasis>УСТАРЕЛ</emphasis>, а начиная с PHP 8.4.0 модуль <emphasis>УДАЛИЛИ</emphasis> из сборки.
+   </simpara>
+  </warning>
  <para>
-   Функции позволяют проверять правописание слова и предлагают
+   Функции проверяют правописание слова и предлагают
   варианты исправления.
  </para>
 </preface>
--- a/reference/pspell/configure.xml
+++ b/reference/pspell/configure.xml
@ -1,24 +1,37 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: northcat Status: ready -->
 <!-- Reviewed: no -->
-<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook">
+<section xml:id="pspell.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;
- <para>
-  Если у вас есть требуемые библиотеки, нужно добавить опцию
-  <option role="configure">--with-pspell[=dir]</option>
-  при компиляции PHP.
- </para>
- <note>
-  <title>Примечание для пользователей Win32</title>
+ <section xml:id="pspell.installation.php84">
+  <title>PHP 8.4</title>
  <para>
-   &ext.windows.path.dll;
-   <filename>aspell-15.dll</filename> из директории
-   <filename>bin</filename> каталога установки aspell.
+   &pecl.moved-ver;8.4.0
  </para>
  <para>
-   Для поддержки Win32 требуется как минимум версия 0.50.
+   &pecl.info;
+   <link xlink:href="&url.pecl.package;pspell">&url.pecl.package;pspell</link>.
  </para>
- </note>
+ </section>
+
+ <section xml:id="pspell.installation.phplt84">
+  <title>PHP &lt; 8.4</title>
+  <para>
+   Модуль включают путём компиляции PHP
+   с параметром <option role="configure">--with-pspell[=dir]</option>.
+  </para>
+  <note>
+   <title>Примечание для пользователей интерфейса Win32</title>
+   <para>
+    &ext.windows.path.dll;
+    Файл <filename>aspell-15.dll</filename>
+    из папки <filename>bin</filename> с установленной программой aspell.
+   </para>
+   <para>
+    Для поддержки интерфейса Win32 потребуется программа Aspell по крайней мере версии 0.50.
+   </para>
+  </note>
+ </section>
 </section>
 <!-- Keep this comment at the end of the file
 Local variables: