Обновление до английской версии (php#281)

Menelion · Aug 28, 2021 · a8a87a2 · a8a87a2
1 parent bb5064e
commit a8a87a2
Show file tree

Hide file tree

Showing 12 changed files with 48 additions and 33 deletions.
diff --git a/language-snippets.ent b/language-snippets.ent
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0799f7789c50a11b746ad713cc8787e4b04dd926 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 
@@ -815,6 +815,8 @@ imap</parameter></term><listitem><para>Поток IMAP, полученный и
 
 <!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">Свойство Unicode для отображения (Смотри константы <literal>IntlChar::PROPERTY_*</literal>).</para>'>
 
+<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Возвращает &null;, если длина <parameter>locale</parameter> превышает <constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>
+
 <!ENTITY intl.property.example 'Тестирование различных свойств'>
 
 <!-- LDAP notes -->

diff --git a/language/functions.xml b/language/functions.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 28ad235028930196e95023f9b41789e1339e7c7e Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 06126805f490aba6f6c107980f673eada0c79e6c Maintainer: sergey Status: ready -->
 <!-- Reviewed: yes -->
 <chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
  <title>Функции</title>
@@ -177,7 +177,7 @@ function recursion($a)
   <simpara>
    Функция может принимать информацию в виде списка аргументов,
    который является списком разделённых запятыми выражений. Аргументы
-   вычисляются слева направо.
+   вычисляются слева направо перед фактическим вызовом функции (<emphasis>энергичное</emphasis> вычисление).
   </simpara>
   <para>
    PHP поддерживает передачу аргументов по значению (по умолчанию), <link

diff --git a/language/oop5/magic.xml b/language/oop5/magic.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5aff4add619c94953775ee25792dc084701c7fac Maintainer: irker Status: ready -->
+<!-- EN-Revision: 3926279f825d418fdd2e7079968507d8b0c62b7d Maintainer: irker Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook">
@@ -57,6 +57,8 @@
    Если объявления типа используются в определении магического метода, они должны быть идентичны сигнатуре, описанной в этом документе.
    В противном случае выдаётся фатальная ошибка.
    До PHP 8.0.0 диагностические сообщения не отправлялись.
+   Однако <link linkend="object.construct">__construct()</link> и
+    <link linkend="object.destruct">__destruct()</link> не должны объявлять возвращаемый тип; в противном случае выдаётся фатальная ошибка.
   </para>
  </warning>
 

diff --git a/reference/intl/locale/accept-from-http.xml b/reference/intl/locale/accept-from-http.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="locale.acceptfromhttp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>string</type>
+   <type class="union"><type>string</type><type>false</type></type>
    <methodname>Locale::acceptFromHttp</methodname>
    <methodparam><type>string</type><parameter>header</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>string</type>
+   <type class="union"><type>string</type><type>false</type></type>
    <methodname>locale_accept_from_http</methodname>
    <methodparam><type>string</type><parameter>header</parameter></methodparam>
   </methodsynopsis>
@@ -57,6 +57,9 @@
   <para>
    Соответствующий идентификатор локали.
   </para>
+  <para>
+    Возвращает &false;, если длина <parameter>header</parameter> превышает <constant>INTL_MAX_LOCALE_LEN</constant>.
+  </para>
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/canonicalize.xml b/reference/intl/locale/canonicalize.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: dda3c59d21d1d7bb6fad4b05b22681168f30e84d Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xml:id="locale.canonicalize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -12,7 +12,9 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <modifier>static</modifier> <type>string</type><methodname>Locale::canonicalize</methodname>
+   <modifier>public</modifier> <modifier>static</modifier>
+   <type class="union"><type>string</type><type>null</type></type>
+   <methodname>Locale::canonicalize</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -40,13 +42,13 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   Канонизированная строка локали.
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
 
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

diff --git a/reference/intl/locale/filter-matches.xml b/reference/intl/locale/filter-matches.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.filtermatches">
@@ -17,7 +17,7 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>bool</type>
+   <type class="union"><type>bool</type><type>null</type></type>
    <methodname>Locale::filterMatches</methodname>
    <methodparam><type>string</type><parameter>langtag</parameter></methodparam>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
@@ -27,7 +27,7 @@
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>bool</type>
+   <type class="union"><type>bool</type><type>null</type></type>
    <methodname>locale_filter_matches</methodname>
    <methodparam><type>string</type><parameter>langtag</parameter></methodparam>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
@@ -77,6 +77,7 @@
   <para>
    &true; если $locale подходит для $langtag, или &false;, если нет.
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/get-all-variants.xml b/reference/intl/locale/get-all-variants.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.getallvariants">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>Locale::getAllVariants</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>locale_get_all_variants</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
@@ -56,6 +56,7 @@
   <para>
    Массив, содержащий список вариантов заданной локали, или &null;, если таковых нет
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/get-keywords.xml b/reference/intl/locale/get-keywords.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 99b3c9956bc3be1bacc32459aa7a2f38f3e9c580 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.getkeywords">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>Locale::getKeywords</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>locale_get_keywords</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
@@ -56,6 +56,7 @@
   <para>
    Ассоциативный массив (<type>array</type>) с парами ключ-значение  для заданной локали
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/get-primary-language.xml b/reference/intl/locale/get-primary-language.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.getprimarylanguage">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>Locale::getPrimaryLanguage</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>locale_get_primary_language</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
@@ -54,8 +54,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Код языка, связанный с локалью или &null; в случае возникновения ошибки.
+   Код языка, связанный с локалью.
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/get-region.xml b/reference/intl/locale/get-region.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.getregion">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>Locale::getRegion</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>locale_get_region</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
@@ -56,6 +56,7 @@
   <para>
    Код региона, связанный с локалью или &null;, если отсутствует.
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/lookup.xml b/reference/intl/locale/lookup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.lookup">
@@ -17,7 +17,7 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>Locale::lookup</methodname>
    <methodparam><type>array</type><parameter>langtag</parameter></methodparam>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
@@ -28,7 +28,7 @@
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>string</type>
+   <type class="union"><type>string</type><type>null</type></type>
    <methodname>locale_lookup</methodname>
    <methodparam><type>array</type><parameter>langtag</parameter></methodparam>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
@@ -91,6 +91,7 @@
   <para>
    Наиболее подходящая данной локали метка языка.
   </para>
+  &intl.locale-len.return;
  </refsect1>
 
  <refsect1 role="examples">

diff --git a/reference/intl/locale/parse-locale.xml b/reference/intl/locale/parse-locale.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 235297daeda99773f68ee59e2efff048e98c1dc5 Maintainer: rjhdby Status: ready -->
 <!-- Reviewed: yes Maintainer: sergey -->
 <!-- $Revision$ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="locale.parselocale">
@@ -17,15 +17,15 @@
   <methodsynopsis>
    <modifier>public</modifier>
    <modifier>static</modifier>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>Locale::parseLocale</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>
   <para>
    &style.procedural;
   </para>
   <methodsynopsis>
-   <type>array</type>
+   <type class="union"><type>array</type><type>null</type></type>
    <methodname>locale_parse</methodname>
    <methodparam><type>string</type><parameter>locale</parameter></methodparam>
   </methodsynopsis>