oci-parse.xml: исправил инфостиль

reference/oci8/functions/oci-parse.xml

@@ -15,16 +15,16 @@
    <methodparam><type>string</type><parameter>sql</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Подготавливает <parameter>sql</parameter> к выполнению,
-   используя соединение <parameter>connection</parameter> и
-   возвращает идентификатор выражения, который может быть далее использован
-   функциями<function>oci_bind_by_name</function>,<function>oci_execute</function>
-   и другими.
+   Функция подготавливает <parameter>sql</parameter>-запрос к выполнению
+   через соединение <parameter>connection</parameter>
+   и возвращает идентификатор запроса, который передают
+   в <function>oci_bind_by_name</function>, <function>oci_execute</function>
+   и другие функции.
   </para>
   <para>
-   Идентификаторы выражений могут быть освобождены функцией
-   <function>oci_free_statement</function> или установкой переменной в
-   &null;.
+   Идентификаторы запросов освобождают функцией
+   <function>oci_free_statement</function> или установкой для переменной
+   значения &null;.
   </para>
  </refsect1>
 
@@ -36,7 +36,7 @@
      <term><parameter>connection</parameter></term>
      <listitem>
       <para>
-       Идентификатор соединения Oracle, полученный из функций
+       Идентификатор соединения Oracle, который получили из функций
        <function>oci_connect</function>, <function>oci_pconnect</function>
        или <function>oci_new_connect</function>.
       </para>
@@ -46,12 +46,12 @@
      <term><parameter>sql</parameter></term>
      <listitem>
       <para>
-       Запрос SQL или PL/SQL.
+       SQL- или PL/SQL-запрос.
       </para>
       <para>
        SQL-запросы <emphasis>не должны</emphasis> заканчиваться
        точкой с запятой (&quot;;&quot;). PL/SQL-запросы
-       <emphasis>должны</emphasis> оканчиваться точкой с запятой
+       <emphasis>должны</emphasis> заканчиваться точкой с запятой
        (&quot;;&quot;).
       </para>
      </listitem>
@@ -63,7 +63,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает дескриптор выражения в случае успешного выполнения или &false; в случае возникновения ошибки.
+   Функция возвращает дескриптор запроса в случае успешного выполнения или &false;,
+   если возникла ошибка.
   </para>
  </refsect1>
 
@@ -71,19 +72,19 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования <function>oci_parse</function> с SQL-запросами</title>
+    <title>Пример использования функции <function>oci_parse</function> с SQL-запросами</title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
 $conn = oci_connect('hr', 'welcome', 'localhost/XE');
 
-// Парсинг запроса. Обратите внимание на отсутствие точки запятой в конце SQL-запроса
+// Парсим запрос. Обратите внимание на отсутствие точки запятой в конце SQL-запроса
 $stid = oci_parse($conn, 'SELECT * FROM employees');
 oci_execute($stid);
 
 echo "<table border='1'>\n";
-while ($row = oci_fetch_array($stid, OCI_ASSOC+OCI_RETURN_NULLS)) {
+while ($row = oci_fetch_array($stid, OCI_ASSOC + OCI_RETURN_NULLS)) {
     echo "<tr>\n";
     foreach ($row as $item) {
         echo "    <td>" . ($item !== null ? htmlentities($item, ENT_QUOTES) : "") . "</td>\n";
@@ -99,14 +100,14 @@ echo "</table>\n";
   </para>
   <para>
    <example>
-    <title>Пример использования <function>oci_parse</function> с PL/SQL-запросами</title>
+    <title>Пример использования функции <function>oci_parse</function> с PL/SQL-запросами</title>
     <programlisting role="php">
 <![CDATA[
 <?php
 
 /*
-  Перед запуском PHP-скрипта, создайте хранимую процедуру в
-  SQL*Plus или SQL Developer:
+  Перед запуском PHP-скрипта, создайте хранимую процедуру
+  в SQL*Plus или SQL Developer:
 
   CREATE OR REPLACE PROCEDURE myproc(p1 IN NUMBER, p2 OUT NUMBER) AS
   BEGIN
@@ -116,6 +117,7 @@ echo "</table>\n";
 */
 
 $conn = oci_connect('hr', 'welcome', 'localhost/XE');
+
 if (!$conn) {
     $e = oci_error();
     trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
@@ -123,7 +125,7 @@ if (!$conn) {
 
 $p1 = 8;
 
-// При парсинге PL/SQL запросов необходимо наличие точки с запятой в конце строки
+// При парсинге PL/SQL-запросов требуется наличие точки с запятой в конце строки
 $stid = oci_parse($conn, 'begin myproc(:p1, :p2); end;');
 oci_bind_by_name($stid, ':p1', $p1);
 oci_bind_by_name($stid, ':p2', $p2, 40);
@@ -135,6 +137,7 @@ print "$p2\n";   // prints 16
 oci_free_statement($stid);
 oci_close($conn);
 
+
 ?>
 ]]>
     </programlisting>
@@ -146,9 +149,9 @@ oci_close($conn);
   &reftitle.notes;
   <note>
    <para>
-    Эта функция <emphasis>не проверяет</emphasis> синтаксис запроса
+    Функция <emphasis>не проверяет</emphasis> синтаксис запроса
     <parameter>sql</parameter>. Единственный способ проверить правильность
-    SQL или PL/SQL-запроса <parameter>sql</parameter> - это выполнить его.
+    SQL- или PL/SQL-запроса <parameter>sql</parameter> — выполнить запрос.
    </para>
   </note>
  </refsect1>