com doc/ru: Improve translation for named arguments: appendices/migration80/new-features.xml language/functions.xml

[email protected] (Alexey Pyltsyn) Sat, 02 Jan 2021 21:13:00 +0000
Newsgroups php.doc.ru
Message-ID <[email protected]>
Commit:    5842fd12101b42961b562688da71fd2469bddc7d
Author:    Alexey Pyltsyn <[email protected]>         Sun, 3 Jan 2021 00:13:00 +0300
Parents:   05ef9fa99467b2067f333a5893a31320f35114b3
Branches:  master

Link:       http://git.php.net/?p=doc/ru.git;a=commitdiff;h=5842fd12101b42961b562688da71fd2469bddc7d

Log:
Improve translation for named arguments

Changed paths:
  M  appendices/migration80/new-features.xml
  M  language/functions.xml


Diff:
diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml
index dfb8b7db5..4e9bfdd53 100644
--- a/appendices/migration80/new-features.xml
+++ b/appendices/migration80/new-features.xml
@@ -14,7 +14,7 @@
 
    <para>
     <!-- RFC: https://wiki.php.net/rfc/named_params -->
-    Добавлена поддержка <link linkend="functions.named-arguments">Именованных аргументов</link>.
+    Добавлена поддержка <link linkend="functions.named-arguments">именованных аргументов</link>.
    </para>
   </sect3>
 
diff --git a/language/functions.xml b/language/functions.xml
index e85ed2c40..6d330e5e8 100644
--- a/language/functions.xml
+++ b/language/functions.xml
@@ -598,18 +598,18 @@ echo sum(1, 2, 3, 4);
     <title>Именованные аргументы</title>
 
     <para>
-     В PHP 8.0.0 представлены именованные аргументы как расширение существующих 
-     позиционных параметров. Именованные аргументы позволяют передавать аргументы 
-     функции на основе имени параметра, а не позиции параметра.
-     Это делает значение аргумента самодокументированным, делает аргументы независимыми от 
-     порядка и позволяет произвольно пропускать значения по умолчанию.
+     В PHP 8.0.0 в виде продолжения позиционных параметров появились именованные аргументы.
+     С помощью их помощью аргументы 
+     функции можно передавать по имени параметра, а не по его позиции.
+     Таким образом аргумент становится самодокументированным, независимым от 
+     порядка и указанного значения по умолчанию.
     </para>
 
     <para>
-     Именованные аргументы передаются с помощью префикса значения с именем параметра, 
-     за которым следует двоеточие. Допускается использование зарезервированных ключевых слов в качестве имен параметров.
-     Имя параметра должно быть идентификатором, динамическое указание 
-     не допускается.
+     Именованные аргументы передаются путём добавления через двоеточия имени параметра перед его значением.
+     В качестве имен параметров можно использовать зарезервированные ключевые слова.
+     Имя параметра должно быть идентификатором, т.е. он не может быть создан 
+     динамически.
     </para>
 
     <example>
@@ -620,7 +620,7 @@ echo sum(1, 2, 3, 4);
 myFunction(paramName: $value);
 array_foobar(array: $value);
 
-// НЕ поддерживается
+// НЕ поддерживается.
 function_name($variableStoringParamName: $value);
 ?>
 ]]>
@@ -628,7 +628,7 @@ function_name($variableStoringParamName: $value);
     </example>
 
     <example>
-     <title>Позиционные аргументы против именованных аргументов</title>
+     <title>Позиционные аргументы в сравнении с именованными аргументами</title>
      <programlisting role="php">
       <![CDATA[
 <?php
@@ -643,11 +643,11 @@ array_fill(start_index: 0, num: 100, value: 50);
     </example>
 
     <para>
-     Порядок, в котором передаются названные аргументы, не имеет значения.
+     Порядок, в котором передаются именованные аргументы, не имеет значения.
     </para>
 
     <example>
-     <title>Тот же пример, что и выше, с другим порядком параметров</title>
+     <title>Тот же пример, что и выше, но с другим порядком параметров</title>
      <programlisting role="php">
       <![CDATA[
 <?php
@@ -658,9 +658,9 @@ array_fill(value: 50, num: 100, start_index: 0);
     </example>
 
     <para>
-     Именованные аргументы можно комбинировать с позиционными аргументами. В этом случае 
-     именованные аргументы должны идти после позиционных аргументов.
-     Также возможно указать только некоторые из необязательных аргументов 
+     Именованные аргументы можно комбинировать с позиционными. В этом случае 
+     именованные аргументы должны следовать после позиционных аргументов.
+     Также возможно передать только часть необязательных аргументов 
      функции, независимо от их порядка.
     </para>
 
@@ -682,7 +682,7 @@ htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);
     </para>
 
     <example>
-     <title>Исключение Error при передаче одного и того же параметра несколько раз</title>
+     <title>Выбрасывание исключения Error при передаче одного и того же параметра несколько раз</title>
      <programlisting role="php">
       <![CDATA[
 <?php