Update reference.xml

reference/pdo_ibm/reference.xml

@@ -3,15 +3,15 @@
 <!-- Reviewed: no -->
 <reference xml:id="ref.pdo-ibm" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="pecl" ?>
- <title>Функции IBM (PDO_IBM)</title>
- <titleabbrev>IBM (PDO)</titleabbrev>
+ <title>Драйвер PDO_IBM: функции БД IBM</title>
+ <titleabbrev>IBM</titleabbrev>
  <partintro>
 
   <section xml:id="pdo-ibm.intro">
    &reftitle.intro;
    <para>
-    PDO_IBM — это драйвер, реализующий интерфейс <link linkend="intro.pdo">PHP Data
-    Objects (PDO)</link> для предоставления возможности работать с базами данных IBM.
+    PDO_IBM — драйвер, через который PHP получает доступ к базам данных IBM.
+    Для этого драйвер реализует интерфейс модуля <link linkend="intro.pdo">PDO</link>.
    </para>
   </section>
 
@@ -24,21 +24,22 @@
 
  <refentry xml:id="ref.pdo-ibm.connection">
   <refnamediv>
-   <refname>PDO_IBM DSN</refname>
+   <refname>DSN-строка подключения через драйвер PDO_IBM</refname>
    <refpurpose>Соединение с базой данных IBM</refpurpose>
   </refnamediv>
 
   <refsect1 role="description">
    &reftitle.description;
    <para>
-    Имя источника данных (Data Source Name, DSN) PDO_IBM базируется на IBM CLI DSN. Главный компонент
-    PDO_IBM DSN:
+    В основе DSN-строки подключения (англ. сокр.: Data Source Name — имя источника данных)
+    через драйвер PDO_IBM лежит DSN-строка CLI-интерфейса IBM. Главные компоненты DSN-строки
+    подключения через драйвер PDO_IBM:
     <variablelist>
      <varlistentry>
-      <term>Префикс DSN</term>
+      <term>DSN-префикс</term>
       <listitem>
        <para>
-        Префикс DSN — <userinput>ibm:</userinput>.
+        DSN-префикс — строка <userinput>ibm:</userinput>.
         </para>
        </listitem>
       </varlistentry>
@@ -46,31 +47,31 @@
        <term>DSN</term>
        <listitem>
         <para>
-         DSN может быть одним из нижеследующего:
+         DSN-строку указывают тремя способами:
          <itemizedlist>
           <listitem>
            <para>
-            a) Настройка источника данных с помощью <filename>db2cli.ini</filename>
+            a) Настройка источника данных в файле <filename>db2cli.ini</filename>
             или <filename>odbc.ini</filename>
            </para>
           </listitem>
           <listitem>
            <para>
-            b) Каталогизированное имя базы данных. Т. е. псевдоним базы данных
-            в каталоге клиента DB2
+            b) Каталогизированное имя базы данных — псевдоним базы данных
+            в каталоге клиента БД DB2
            </para>
           </listitem>
           <listitem>
            <para>
-            c) Полноценная строка соединения:
+            c) Полная строка подключения в следующем формате:
             <code>DRIVER={IBM DB2 ODBC DRIVER};DATABASE=<parameter>database</parameter>;HOSTNAME=<parameter>hostname</parameter>;PORT=<parameter>port</parameter>;PROTOCOL=TCPIP;UID=<parameter>username</parameter>;PWD=<parameter>password</parameter>;</code>,
-            где параметры означают следующее:
+            где параметры представляют следующие значения:
             <variablelist>
              <varlistentry>
               <term><parameter>database</parameter></term>
               <listitem>
                <para>
-                Имя базы данных.
+                Название базы данных.
                </para>
               </listitem>
              </varlistentry>
@@ -86,7 +87,7 @@
               <term><parameter>port</parameter></term>
               <listitem>
                <para>
-                Порт TCP/IP, на котором слушает база.
+                Порт TCP/IP, на котором база данных слушает запросы.
                </para>
               </listitem>
              </varlistentry>
@@ -120,10 +121,10 @@
     &reftitle.examples;
     <para>
      <example>
-      <title>Пример PDO_IBM DSN с файлом <filename>db2cli.ini</filename></title>
+      <title>Пример DSN-строки подключения через драйвер PDO_IBM с файлом <filename>db2cli.ini</filename></title>
       <para>
-       Следующий пример демонстрирует PDO_IBM DSN для соединения с базой DB2
-       указанной как DB2_9 в <filename>db2cli.ini</filename>:
+       Следующий пример показывает DSN-строку подключения через драйвер PDO_IBM
+       для соединения с базой DB2, которую каталогизировали как DB2_9 в файле <filename>db2cli.ini</filename>:
 <programlisting><![CDATA[
 $db = new PDO("ibm:DSN=DB2_9", "", "");
 
@@ -136,10 +137,11 @@ Servicename=56789
       </para>
      </example>
      <example>
-      <title>Пример PDO_IBM DSN со строкой соединения</title>
+      <title>Пример DSN-строки подключения через драйвер PDO_IBM со строкой соединения</title>
       <para>
-       Следующий пример показывает PDO_IBM DSN для соединения с базой DB2
-       с именем <userinput>testdb</userinput>, используя синтаксис соединения DB2 CLI.
+       Следующий пример показывает DSN-строку подключения через драйвер PDO_IBM
+       для соединения с базой DB2 с названием <userinput>testdb</userinput>,
+       которую записали синтаксисом соединения с CLI-интерфейса БД DB2.
 <programlisting><![CDATA[
 $db = new PDO("ibm:DRIVER={IBM DB2 ODBC DRIVER};DATABASE=testdb;" .
   "HOSTNAME=11.22.33.444;PORT=56789;PROTOCOL=TCPIP;", "testuser", "tespass");