Update Intl to En

appendices/migration85/new-classes.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ec45af749649dc0d6a23eaedeed1b601f7460813 Maintainer: sergey Status: ready -->
+<!-- EN-Revision: e1b9f588815a51682acf68f9b8929f49ad612488 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <sect1 xml:id="migration85.new-classes" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Новые классы, перечисления и интерфейсы</title>
@@ -27,6 +27,13 @@
   </simplelist>
  </sect2>
 
+ <sect2 xml:id="migration85.new-classes.intl">
+  <title>Intl</title>
+  <simplelist>
+   <member><classname>IntlListFormatter</classname></member>
+  </simplelist>
+ </sect2>
+
  <sect2 xml:id="migration85.new-classes.uri">
   <title>Модуль URI</title>
   <simplelist>

reference/intl/book.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 91791cdde04dd89898656fbec1aa8e7e0bf0460d Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: e1b9f588815a51682acf68f9b8929f49ad612488 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: no -->
 <book xml:id="book.intl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
@@ -9,86 +9,83 @@
  <!-- {{{ Preface -->
  <preface xml:id="intro.intl">
   &reftitle.intro;
-  <para>
-   Модуль интернационализации (далее Intl) - это обёртка для библиотеки
-   <link xlink:href="&url.icu.home;">ICU</link>, позволяющая программистам на PHP
-   производить различные операции, которые зависят от локали, например,
-   форматирование, транслитерация, преобразование кодировок, операции с календарём,
-   совместимое с <link xlink:href="&url.icu.uca;">UCA</link>
-   сравнение, определение
-   границ текста и работать с идентификаторами локалей, часовыми поясами
-   и графемами.
-  </para>
-  <para>
-   Программный интерфейс модуля разрабатывается так, чтобы как можно точнее повторять
-   API ICU, чтобы люди, работавшие с ICE в C/C++ или Java, могли легко использовать API PHP.
-   Также благодаря этому документация ICE может быть полезной чтобы понять различие функции ICU.
-  </para>
+  <simpara>
+   Модуль интернационализации (далее — Intl) — обёртка над библиотекой
+   <link xlink:href="&url.icu.home;">ICU</link>. Компоненты модуля Intl открывают PHP-программистам
+   доступ к форматированию, транслитерации, преобразованию кодировок, операциям с календарём,
+   совместимому <link xlink:href="&url.icu.uca;">с алгоритмом UCA</link>
+   сопоставлению, определению границ текста,
+   работе с идентификаторами локалей, часовыми поясами, графемами и к другим операциям,
+   которые модуль выполняет с учётом языковых и региональных стандартов.
+  </simpara>
 
-  <para>
-   Intl состоит из нескольких модулей, каждый из которых предоставляет соответствующий API ICU:
-  </para>
+  <simpara>
+   Сходство API модуля Intl и библиотеки ICU
+   помогает применять навык работы с функциями библиотеки в языках C/C++ или Java и при работе с API библиотеки ICU в PHP
+   и делает документацию к библиотеке ICU полезной для понимания закулисной работы функций PHP-модуля.
+  </simpara>
+
+  <simpara>
+   Каждый компонент PHP-модуля Intl раскрывает API к конкретному модулю библиотеки API:
+  </simpara>
 
   <itemizedlist>
    <listitem>
     <simpara>
-     Модуль сравнения: предоставляет инструменты для сравнения строк
-     с поддержкой соответствующего локали порядка сортировки.
+     Модуль сопоставления: инструмент сравнения строк
+     с учётом языковых и региональных правил сортировки.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль форматирования чисел: позволяет отображать числа в соответствии с
-     правилами локали, или заданным шаблоном или с набором правил.
-     Также позволяет правильно разбирать строки в числа.
+     Модуль форматирования чисел: форматирует числа
+     с учётом локали, по шаблону или набору правил;
+     разбирает строки с числами.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль форматирования сообщений: позволяет создавать сообщения, включающие
-     данные (такие как числа и даты), отформатированные в соответствии с
-     заданными шаблоном и локальными правилами, и, также, разбирать
-     сообщения, извлекая из них данные.
+     Модуль форматирования сообщений: создаёт сообщение по шаблону
+     и форматирует числа, даты или другие данные в шаблоне по правилам языкового и регионального стандарта;
+     разбирает сообщения для извлечения данных.
+     При формировании сообщения поддерживаются: множественное число, числа с учётом локали, валюты, условные конструкции и другие подстановки.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль нормализации: предоставляет функции для преобразования текста
-     в одну из нормализованных форм Unicode. Также предоставляет возможность
-     проверить, является ли предоставленный текст уже нормализованным.
+     Модуль нормализации: приводит текст к нормализованным формам, которые определяет стандарт Юникод.
+     Проверяет, соответствует ли строка конкретной форме нормализации.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль локали: предоставляет взаимодействие с идентификаторами
-     локали как к функциями, позволяя получить вложенные теги локали;
-     разбор, композиция, сравнение (поиск и фильтрация) идентификаторов локали.
+     Модуль локали: разбирает на подтеги, собирает, находит по приоритету и фильтрует идентификаторы локалей.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль календаря: предоставляет класс, полезный для проведения зависимых
-     от локали операций с календарём, получения различной информации, такой как
-     часовые пояса для выбранной локали, первый день недели или
-     режим текущего зимнего/летнего времени.
+     Модуль календаря: класс, который выполняет операции с календарём
+     с учётом локали:
+     получает сведения о часовом поясе, первом дне недели
+     или текущем режиме летнего времени.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль часового пояса: предоставляет обёртку над <link xlink:href="&url.icu.tzdatabase;">базой данных часовых поясов</link>,
-     в которой содержится исчерпывающая информация о всех мировых часовых поясах.
+     Модуль часового пояса: обёртка <link xlink:href="&url.icu.tzdatabase;">над базой данных IANA</link>,
+     которая содержит сведения о часовых поясах мира.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль форматирования даты: позволяет отображать дату в соответствии с
-     принятым для данной локали форматом либо заданным шаблоном или набором правил.
-     Также нужен для разбора строк, содержащих описание даты и времени.
+     Модуль форматирования даты: форматирует дату и время
+     по правилам языкового и регионального стандарта, по шаблону или набору правил;
+     разбирает строки с датой и временем.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
-     Модуль транслитерации: позволяет получить представление строки на различных языках в латинице.
+     Модуль транслитерации: преобразовывает строки на национальных, региональных и других языках в латинское представление.
     </simpara>
    </listitem>
   </itemizedlist>
@@ -98,13 +95,13 @@
    <title>Ссылки</title>
    <itemizedlist>
     <listitem>
-     <para><link xlink:href="&url.icu.docs;">Различная документация ICU</link></para>
+     <simpara><link xlink:href="&url.icu.docs;">Документация к библиотеке ICU</link></simpara>
     </listitem>
     <listitem>
-     <para><link xlink:href="&url.icu.userguide;">Руководство пользователя ICU</link></para>
+     <simpara><link xlink:href="&url.icu.userguide;">Руководство пользователя ICU</link></simpara>
     </listitem>
     <listitem>
-     <para><link xlink:href="&url.icu.uca;">Алгоритм сопоставления Unicode</link></para>
+     <simpara><link xlink:href="&url.icu.uca;">Алгоритм сопоставления в Юникоде</link></simpara>
     </listitem>
    </itemizedlist>
   </section>
@@ -133,6 +130,7 @@
  &reference.intl.intlrulebasedbreakiterator;
  &reference.intl.intlcodepointbreakiterator;
  &reference.intl.intldatepatterngenerator;
+ &reference.intl.intllistformatter;
  &reference.intl.intlpartsiterator;
  &reference.intl.uconverter;