pg-prepare.xml Amend XML syntax, add tags, clarify purpose

php/doc-en@469e5fa

Author: mumumu

reference/pgsql/functions/pg-prepare.xml

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 469e5fa809cef61c0707d7447a2ab72cd66f65fd Maintainer: takagi Status: ready -->
 <refentry xml:id="function.pg-prepare" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>pg_prepare</refname>
   <refpurpose>
    指定したパラメータでプリペアドステートメントを作成するリクエストを
-   送信し、その完了を待つ
+   サーバーに送信し、その完了を待つ
   </refpurpose>
  </refnamediv>
 
@@ -30,11 +30,11 @@
     この関数は <parameter>stmtname</parameter> という名前の
     プリペアドステートメントを <parameter>query</parameter> 文字列から作成します。
     この文字列には 1 つの SQL コマンドが含まれている必要があります。
-    <parameter>stmtname</parameter> を "" にすることで無名ステートメントを
+    <parameter>stmtname</parameter> を <literal>""</literal> にすることで無名ステートメントを
     作成することが可能で、既存の無名ステートメントは自動的に上書きされます。
     それ以外の場合、もしカレントのセッションで既に定義済みのステートメント名を
     使用した場合にはエラーとなります。パラメータを使用する際は、
-    <parameter>query</parameter> 内で $1、$2 のような形式で参照されます。
+    <parameter>query</parameter> 内で <literal>$1</literal>、<literal>$2</literal> のような形式で参照されます。
   </para>
   <para>
     <function>pg_prepare</function> で使用するプリペアドステートメントは、
@@ -61,7 +61,7 @@
      <listitem>
       <para>
        プリペアドステートメントにつける名前。接続内で一意である必要があります。
-       "" が指定された場合は無名ステートメントが作成され、以前に定義された
+       <literal>""</literal> が指定された場合は無名ステートメントが作成され、以前に定義された
        無名ステートメントを上書きします。
       </para>
      </listitem>
@@ -72,7 +72,7 @@
       <para>
        パラメータ化した SQL 文。ひとつの文のみである必要があります
        （複数の文をセミコロンで区切る形式は使用できません）。パラメータを
-       使用する際は $1、$2 などの形式で参照されます。
+       使用する際は <literal>$1</literal>、<literal>$2</literal> などの形式で参照されます。
       </para>
      </listitem>
     </varlistentry>
@@ -116,6 +116,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
 // "mary"という名前のデータベースに接続
 $dbconn = pg_connect("dbname=mary");