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

reference/dom/domdocument/createattribute.xml

@@ -4,7 +4,7 @@
 <refentry xml:id="domdocument.createattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument::createAttribute</refname>
-  <refpurpose>Создать новый атрибут</refpurpose>
+  <refpurpose>Создаёт новый атрибут</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -35,7 +35,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Новый объект <classname>DOMAttr</classname> либо &false; в случае
+   Возвращает новый объект <classname>DOMAttr</classname> либо &false; в случае
    возникновения ошибки.
   </para>
  </refsect1>
@@ -47,7 +47,7 @@
      <term><constant>DOM_INVALID_CHARACTER_ERR</constant></term>
      <listitem>
       <para>
-       Возникает, если <parameter>localName</parameter> содержит недопустимые
+       Возникает, если параметр <parameter>localName</parameter> содержит недопустимые
        символы.
       </para>
      </listitem>

reference/dom/domdocument/createdocumentfragment.xml

@@ -5,7 +5,7 @@
  <refnamediv>
   <refname>DOMDocument::createDocumentFragment</refname>
   <refpurpose>
-   Создать новый фрагмент документа
+   Создаёт новый фрагмент документа
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -28,7 +28,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Новый объект класса <classname>DOMDocumentFragment</classname>.
+   Возвращает новый объект класса <classname>DOMDocumentFragment</classname>.
   </para>
  </refsect1>
 

reference/dom/domdocument/createelement.xml

@@ -4,7 +4,7 @@
 <refentry xml:id="domdocument.createelement" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>DOMDocument::createElement</refname>
-  <refpurpose>Создать новый узел элемента</refpurpose>
+  <refpurpose>Создаёт новый узел элемента</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -35,14 +35,14 @@
      <listitem>
       <para>
        Значение элемента. По умолчанию будет создан пустой элемент.
-       Значение может быть установлено позднее с помощью <link
-       linkend="domnode.props.nodevalue">DOMElement::$nodeValue</link>.
+       Значение также может быть установлено позднее путём присваивания при прямом обращении к свойству
+       <link linkend="domnode.props.nodevalue">DOMElement::$nodeValue</link>.
       </para>
       <para>
-       Значение используется дословно, за исключением &lt; и &gt;, которые
-       будут экранированы. Обратите внимание, что &amp; должен быть
-       экранирован самостоятельно, в противном случае он будет рассматриваться
-       как начало ссылки на сущность. Также " не будет экранирован.
+       Значение будет установлено дословно, за исключением символов &lt; и &gt;, которые
+       будут экранированы. Обратите внимание, что символ &amp; нужно
+       экранировать самому, иначе он будет рассматриваться
+       как начало ссылки на сущность. Символ кавчек " также не будет экранирован.
       </para>
      </listitem>
     </varlistentry>
@@ -64,7 +64,7 @@
      <term><constant>DOM_INVALID_CHARACTER_ERR</constant></term>
      <listitem>
       <para>
-       Возникает, если <parameter>localName</parameter> содержит недопустимые
+       Возникает, если параметр <parameter>localName</parameter> содержит недопустимые
        символы.
       </para>
      </listitem>

reference/dom/domelement/getelementsbytagnamens.xml

@@ -5,7 +5,7 @@
  <refnamediv>
   <refname>DOMElement::getElementsByTagNameNS</refname>
   <refpurpose>
-   Получение элементов по локальному имени в заданном пространстве имён
+   Получает элементы по локальному имени в заданном пространстве имён
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -16,9 +16,9 @@
    <methodparam><type>string</type><parameter>localName</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Эта функция выбирает все элементы-потомки с заданным именем
-   <parameter>localName</parameter> и пространством имён
-   <parameter>namespace</parameter>.
+   Функция выбирает все элементы-потомки с заданным
+   в параметре <parameter>localName</parameter> именем и пространством имён,
+   указанном в параметре <parameter>namespace</parameter>.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -31,7 +31,7 @@
       <para>
        URI пространства имён элементов для поиска.
        Специальное значение <literal>"*"</literal> соответствует всем пространствам имён.
-       Передача &null; соответствует пустому пространству имён.
+       Передача значения &null; соответствует пустому пространству имён.
       </para>
      </listitem>
     </varlistentry>
@@ -50,7 +50,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Эта функция возвращает новый объект класса
+   Возвращает новый объект класса
    <classname>DOMNodeList</classname>, содержащий все найденные элементы
    в том порядке, в котором они появляются при прямом обходе дерева.
   </para>

reference/dom/domelement/setattributens.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4f5e2b22575131fa5e9c3004b1c874e1acb06573 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: a8dc22c06600603a7ec57afc6296ae002df250e8 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="domelement.setattributens" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -15,9 +15,10 @@
    <methodparam><type>string</type><parameter>value</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Устанавливает атрибут с пространстве имён
-   <parameter>namespace</parameter> и локальным именем
-   <parameter>name</parameter>. Если атрибут не существует, он будет создан.
+   Устанавливает атрибут с пространством имён, переданным
+   в параметр <parameter>namespace</parameter>,
+   и именем, переданным в параметр <parameter>qualifiedName</parameter>.
+   Если атрибут не существует, он будет создан.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -73,9 +74,9 @@
      <term><constant>DOM_NAMESPACE_ERR</constant></term>
      <listitem>
       <para>
-       Возникает, если значение <parameter>qualifiedName</parameter>
-       неверно, или если <parameter>qualifiedName</parameter>
-       имеет префикс, а <parameter>namespaceURI</parameter> - &null;.
+       Возникает, если квалифицированное имя параметра <parameter>qualifiedName</parameter>
+       неверно или значение параметра <parameter>qualifiedName</parameter>
+       содержит префикс, а значение параметра <parameter>namespaceURI</parameter> — &null;.
       </para>
      </listitem>
     </varlistentry>

reference/dom/domelement/setidattribute.xml

@@ -5,7 +5,7 @@
  <refnamediv>
   <refname>DOMElement::setIdAttribute</refname>
   <refpurpose>
-   Объявляет атрибут, указанный именем, с идентификатором типа
+   Объявляет атрибуту c указанным именем тип ID
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -16,7 +16,8 @@
    <methodparam><type>bool</type><parameter>isId</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Объявляет атрибут <parameter>qualifiedName</parameter> с идентификатором типа.
+   Объявляет атрибут с квалифицированным именем <parameter>qualifiedName</parameter>
+   уникальным идентификатором элемента.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -35,8 +36,10 @@
      <term><parameter>isId</parameter></term>
      <listitem>
       <para>
-       Установите значение в &true; если вы хотите, чтобы
-       <parameter>qualifiedName</parameter> имел идентификатор типа, &false; в противном случае.
+       Параметр устанавливают в &true;, если нужно, чтобы тип атрибута,
+       имя которого указано в параметре <parameter>qualifiedName</parameter>,
+       стал идентификатором элемента,
+       иначе указывают &false;.
       </para>
      </listitem>
     </varlistentry>
@@ -67,8 +70,8 @@
      <term><constant>DOM_NOT_FOUND</constant></term>
      <listitem>
       <para>
-       Возникает, если  <parameter>qualifiedName</parameter> не является атрибутом
-       элемента.
+       Возникает, если имя <parameter>qualifiedName</parameter> не принадлежит
+       элементу.
       </para>
      </listitem>
     </varlistentry>

reference/dom/domelement/setidattributenode.xml

@@ -5,7 +5,7 @@
  <refnamediv>
   <refname>DOMElement::setIdAttributeNode</refname>
   <refpurpose>
-   Объявляет атрибут, указанный узлом, с идентификатором типа
+   Объявляет указанному узлу атрибута тип ID
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -16,8 +16,8 @@
    <methodparam><type>bool</type><parameter>isId</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Объявляет атрибут, определяемый узлом <parameter>attr</parameter>,
-   идентификатором типа.
+   Объявляет атрибут, определённый узлом <parameter>attr</parameter>,
+   уникальным идентификатором элемента.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -36,8 +36,9 @@
      <term><parameter>isId</parameter></term>
      <listitem>
       <para>
-       Установите значение в &true; если вы хотите, чтобы
-       <parameter>name</parameter> имел идентификатор типа, &false; в противном случае.
+       Параметр устанавливают в &true;, если нужно, чтобы тип переданного атрибута
+       с именем <parameter>name</parameter> стал идентификатором элемента,
+       иначе указывают &false;.
       </para>
      </listitem>
     </varlistentry>
@@ -68,8 +69,8 @@
      <term><constant>DOM_NOT_FOUND</constant></term>
      <listitem>
       <para>
-       Возникает, если <parameter>name</parameter> не является атрибутом
-       элемента.
+       Возникает, если атрибут с именем <parameter>name</parameter> не принадлежит
+       элементу.
       </para>
      </listitem>
     </varlistentry>

reference/dom/domelement/setidattributens.xml

@@ -5,7 +5,7 @@
  <refnamediv>
   <refname>DOMElement::setIdAttributeNS</refname>
   <refpurpose>
-   Объявляет атрибут, указанный локальным именем и URI пространства имён, с идентификатором типа
+   Объявляет атрибуту с указанными локальным именем и URI пространства имён тип ID
   </refpurpose>
  </refnamediv>
  <refsect1 role="description">
@@ -17,9 +17,9 @@
    <methodparam><type>bool</type><parameter>isId</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Объявляет атрибут, указанный локальным именем
+   Объявляет атрибут c указанными квалифицированным именем
    <parameter>qualifiedName</parameter> и пространством имён
-   <parameter>namespace</parameter>, идентификатором типа.
+   <parameter>namespace</parameter> уникальным идентификатором элемента.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -46,8 +46,9 @@
      <term><parameter>isId</parameter></term>
      <listitem>
       <para>
-       Установите значение в &true; если вы хотите, чтобы
-       <parameter>name</parameter> имел идентификатор типа, &false; в противном случае.
+       Параметр устанавливают в &true;, если нужно, чтобы тип атрибута
+       с именем <parameter>name</parameter> стал идентификатором элемента,
+       иначе указывают &false;.
       </para>
      </listitem>
     </varlistentry>
@@ -78,8 +79,8 @@
      <term><constant>DOM_NOT_FOUND</constant></term>
      <listitem>
       <para>
-       Возникает, если  <parameter>name</parameter> не является атрибутом
-       элемента.
+       Возникает, если атрибут с именем <parameter>name</parameter> не принадлежит
+       элементу.
       </para>
      </listitem>
     </varlistentry>