[DOCUMENTATION]Japanese sync 19173

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19191 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ja/module_specs/Zend_Db_Adapter.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18821 -->
+<!-- EN-Revision: 19173 -->
 <sect1 id="zend.db.adapter">
 
     <title>Zend_Db_Adapter</title>
@@ -602,7 +602,7 @@ CREATE TABLE bugs_products (
         <title>クエリ結果の読み込み</title>
 
         <para>
-            ここでは、SELECT クエリを実行してその結果を取得するための
+            ここでは、 <acronym>SELECT</acronym> クエリを実行してその結果を取得するための
             アダプタのメソッドについて説明します。
         </para>
 
@@ -611,17 +611,17 @@ CREATE TABLE bugs_products (
             <title>結果セット全体の取得</title>
 
             <para>
-                <acronym>SQL</acronym> の SELECT クエリの実行とその結果の取得を一度に行うには
+                <acronym>SQL</acronym> の <acronym>SELECT</acronym> クエリの実行とその結果の取得を一度に行うには
                 <methodname>fetchAll()</methodname> メソッドを使用します。
             </para>
 
             <para>
-                このメソッドの最初の引数には、SELECT 文を文字列で指定します。
+                このメソッドの最初の引数には、 <acronym>SELECT</acronym> 文を文字列で指定します。
                 あるいは、文字列ではなく
                 <link linkend="zend.db.select">Zend_Db_Select</link>
                 クラスのオブジェクトを指定することもできます。
                 オブジェクトを渡した場合は、アダプタの内部でそれを自動的に
-                SELECT 文の文字列に変換します。
+                <acronym>SELECT</acronym> 文の文字列に変換します。
             </para>
 
             <para>
@@ -667,10 +667,10 @@ $result = $db->fetchAll($sql, 2);
                     </para>
                     <para>
                         select で取得する一覧の中に同名のカラムが含まれている場合
-                        (たとえば複数テーブルを JOIN した場合など)
+                        (たとえば複数テーブルを <acronym>JOIN</acronym> した場合など)
                         は、その名前のエントリはひとつしか含まれません。
-                        FETCH_ASSOC モードを使用する場合は、
-                        SELECT クエリでカラムの別名を指定するなどして、
+                        <acronym>FETCH_ASSOC</acronym> モードを使用する場合は、
+                        <acronym>SELECT</acronym> クエリでカラムの別名を指定するなどして、
                         結果の配列におけるキーが一意になるようにしなければなりません。
                     </para>
                     <para>
@@ -793,13 +793,13 @@ echo $result[0];
             <para>
                 <methodname>fetchPairs()</methodname> メソッドは、データを キー/値
                 のペア (連想配列) の配列で返します。
-                この連想配列のキーは、SELECT クエリが返す最初のカラムの値となります。
-                また、連想配列の値は、SELECT クエリが返す二番目のカラムの値となります。
+                この連想配列のキーは、 <acronym>SELECT</acronym> クエリが返す最初のカラムの値となります。
+                また、連想配列の値は、 <acronym>SELECT</acronym> クエリが返す二番目のカラムの値となります。
                 クエリから返されるその他のカラムは破棄されます。
             </para>
 
             <para>
-                SELECT クエリをうまく設計し、最初のカラムの値が一意になるようにしなければなりません。
+                <acronym>SELECT</acronym> クエリをうまく設計し、最初のカラムの値が一意になるようにしなければなりません。
                 もし最初のカラムに重複する値があれば、連想配列のエントリが上書きされてしまいます。
             </para>
 
@@ -900,9 +900,9 @@ $db->insert('bugs', $data);
 
             <para>
                 データの配列で指定しなかったカラムについてはデータベースに対して何も指示しません。
-                つまり、<acronym>SQL</acronym> の INSERT 文で列を指定しなかった場合と同じ挙動となります。
-                DEFAULT 句が設定されていればその値が追加され、
-                設定されていなければ NULL のままとなります。
+                つまり、<acronym>SQL</acronym> の <acronym>INSERT</acronym> 文で列を指定しなかった場合と同じ挙動となります。
+                <acronym>DEFAULT</acronym> 句が設定されていればその値が追加され、
+                設定されていなければ <acronym>NULL</acronym> のままとなります。
             </para>
 
             <para>
@@ -941,7 +941,7 @@ $db->insert('bugs', $data);
 
             <para>
                 <acronym>RDBMS</acronym> によっては、主キーの自動インクリメントをサポートしているものもあります。
-                この方法で定義したテーブルに新しい行を INSERT すると、
+                この方法で定義したテーブルに新しい行を <acronym>INSERT</acronym> すると、
                 主キーの値が自動的に生成されます。
                 <methodname>insert()</methodname> メソッドの返り値は、最後に追加された ID
                 では<emphasis>ありません</emphasis>。
@@ -1014,7 +1014,7 @@ $id = $db->lastSequenceId('bugs_id_gen');
                 Microsoft SQL Server、SQLite などの場合、
                 <methodname>lastInsertId()</methodname> メソッドの引数は無視されます。
                 このメソッドの返り値は、現在の接続で最後に実行された
-                INSERT 操作が生成した値となります。また、これらの <acronym>RDBMS</acronym> では
+                <acronym>INSERT</acronym> 操作が生成した値となります。また、これらの <acronym>RDBMS</acronym> では
                 <methodname>lastSequenceId()</methodname> メソッドの返り値は常に <constant>NULL</constant>
                 となります。
             </para>
@@ -1042,7 +1042,7 @@ $id = $db->lastSequenceId('bugs_id_gen');
                 <para>
                     さらに、新しい主キーの値を生成する際に "MAX(id)+1"
                     のような式を使うのも同様に危険です。ふたつのクライアントから同時にこのクエリを実行すると、
-                    どちらも同じ値を取得することになり、同じ値で INSERT
+                    どちらも同じ値を取得することになり、同じ値で <acronym>INSERT</acronym>
                     を行なうことになってしまいます。
                 </para>
                 <para>
@@ -2092,13 +2092,13 @@ if (!is_null($version)) {
                         オプションの配列で、キーとして <property>pdoType</property>
                         を指定できます。この値は "mssql" (デフォルト)、
                         "dblib"、"freetds" あるいは "sybase" のいずれかとなります。
-                        このオプションは、DSN 文字列を作成する際に使用する
-                        DSN プレフィックスに影響を与えます。"freetds" および
+                        このオプションは、 <acronym>DSN</acronym> 文字列を作成する際に使用する
+                        <acronym>DSN</acronym> プレフィックスに影響を与えます。"freetds" および
                         "sybase" を指定した場合のプレフィックスは
                         "sybase:" となります。これは
                         <ulink url="http://www.freetds.org/">FreeTDS</ulink>
                         系のライブラリで用いられるものです。
-                        このドライバで使用できる DSN プレフィックスの詳細は
+                        このドライバで使用できる <acronym>DSN</acronym> プレフィックスの詳細は
                         <ulink url="http://www.php.net/manual/ja/ref.pdo-dblib.connection.php">
                         http://www.php.net/manual/ja/ref.pdo-dblib.connection.php</ulink>
                         を参照ください。
@@ -2215,7 +2215,7 @@ if (!is_null($version)) {
                         SQLite2 データベースに接続するには、
                         <classname>Pdo_Sqlite</classname> アダプタのインスタンスを作成する際に
                         パラメータの配列で
-                        <code>'sqlite2'=>true</code> を指定します。
+                        <command>'sqlite2' => true</command> を指定します。
                     </para>
                 </listitem>
                 <listitem>
@@ -2223,7 +2223,7 @@ if (!is_null($version)) {
                         メモリ上の SQLite データベースに接続するには、
                         <classname>Pdo_Sqlite</classname> アダプタのインスタンスを作成する際に
                         パラメータの配列で
-                        <code>'dbname'=>':memory:'</code> を指定します。
+                        <command>'dbname' => ':memory:'</command> を指定します。
                     </para>
                 </listitem>
                 <listitem>

documentation/manual/ja/module_specs/Zend_Db_Profiler.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17600 -->
+<!-- EN-Revision: 19173 -->
 <sect1 id="zend.db.profiler" xmlns:xi="http://www.w3.org/2001/XInclude">
 
     <title>Zend_Db_Profiler</title>
@@ -10,7 +10,7 @@
         <title>導入</title>
 
         <para>
-            <classname>Zend_Db_Profiler</classname> を使用すると、クエリの情報を取得することができます。
+            <classname>Zend_Db_Profiler</classname> を使用すると、クエリの情報を取得できます。
             アダプタが実際に実行したクエリの内容や実行所要時間などが取得でき、
             余計なデバッグコードをクラスに追加しなくてもクエリを調べられるようになります。
             さらに、条件を指定して特定のクエリだけの情報を取得することもできます。
@@ -41,7 +41,7 @@ $db->getProfiler()->setEnabled(true);
 ]]></programlisting>
 
         <para>
-            <code>profiler</code> オプションの値には柔軟性があり、
+            <property>profiler</property> オプションの値には柔軟性があり、
             その型に応じて、さまざまな形式で解釈されます。
             たいていは単純な boolean 値を指定することになるでしょうが、
             その他の型を指定することでプロファイラの振る舞いをカスタマイズすることも可能です。
@@ -53,65 +53,75 @@ $db->getProfiler()->setEnabled(true);
             にすると、プロファイラを無効にします。プロファイラのクラスは、
             そのアダプタのデフォルトのプロファイラクラスである
             <classname>Zend_Db_Profiler</classname> となります。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+<programlisting language="php"><![CDATA[
 $params['profiler'] = true;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
-        </para>
 
         <para>
             プロファイラオブジェクトのインスタンスを、アダプタで使用します。
             このオブジェクトの型は、<classname>Zend_Db_Profiler</classname>
             あるいはそのサブクラスでなければなりません。
             プロファイラを有効にするには、次にようにします。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+<programlisting language="php"><![CDATA[
 $profiler = MyProject_Db_Profiler();
 $profiler->setEnabled(true);
 $params['profiler'] = $profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
-        </para>
 
         <para>
-            引数は連想配列で、'<code>enabled</code>'、
-            '<code>instance</code>' および '<code>class</code>'
+            引数は連想配列で、'<property>enabled</property>'、
+            '<property>instance</property>' および '<property>class</property>'
             のいずれか (あるいはすべて) のキーを持ちます。
-            '<code>enabled</code>' と '<code>instance</code>' は、
+            '<property>enabled</property>' と '<property>instance</property>' は、
             それぞれ boolean および上で説明したインスタンスです。
-            '<code>class</code>' は、独自のプロファイラを使用する場合のクラス名を指定します。
+            '<property>class</property>' は、独自のプロファイラを使用する場合のクラス名を指定します。
             このクラスは <classname>Zend_Db_Profiler</classname> あるいはそのサブクラスでなければなりません。
             このクラスは、コンストラクタに何も引数を渡さないでインスタンス化されます。
-            '<code>class</code>' の内容は、
-            '<code>instance</code>' を指定した際には無視されます。
-            <programlisting language="php"><![CDATA[
+            '<property>class</property>' の内容は、
+            '<property>instance</property>' を指定した際には無視されます。
+        </para>
+
+<programlisting language="php"><![CDATA[
 $params['profiler'] = array(
     'enabled' => true,
     'class'   => 'MyProject_Db_Profiler'
 );
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
-        </para>
 
         <para>
             また、引数は <classname>Zend_Config</classname> のオブジェクトで渡すこともできます。
             このオブジェクトのプロパティが、先ほどの連想配列のキーと同じように解釈されます。
-            たとえば、次のような内容の "config.ini" ファイルがあったとしましょう。
-            <programlisting language="ini"><![CDATA[
+            たとえば、次のような内容の "<filename>config.ini</filename>" ファイルがあったとしましょう。
+        </para>
+
+<programlisting language="ini"><![CDATA[
 [main]
 db.profiler.class   = "MyProject_Db_Profiler"
 db.profiler.enabled = true
 ]]></programlisting>
 
-            この設定を適用するには、次のような PHP コードを書きます。
+        <para>
+            この設定を適用するには、次のような <acronym>PHP</acronym> コードを書きます。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+<programlisting language="php"><![CDATA[
 $config = new Zend_Config_Ini('config.ini', 'main');
 $params['profiler'] = $config->db->profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 
-            '<code>instance</code>' プロパティは、次のように使用します。
-            <programlisting language="php"><![CDATA[
+        <para>
+            '<property>instance</property>' プロパティは、次のように使用します。
+        </para>
+
+<programlisting language="php"><![CDATA[
 $profiler = new MyProject_Db_Profiler();
 $profiler->setEnabled(true);
 $configData = array(
@@ -122,8 +132,6 @@ $params['profiler'] = $config;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
 ]]></programlisting>
 
-        </para>
-
     </sect2>
 
     <sect2 id="zend.db.profiler.using">
@@ -312,25 +320,25 @@ $profiler->setFilterElapsedSecs(null);
                     <para>
                         <constant>Zend_Db_Profiler::INSERT</constant>:
                         新しいデータをデータベースに追加するクエリ。
-                        一般的には <acronym>SQL</acronym> の INSERT。
+                        一般的には <acronym>SQL</acronym> の <acronym>INSERT</acronym>。
                     </para>
                 </listitem>
                 <listitem>
                     <para>
                         <constant>Zend_Db_Profiler::UPDATE</constant>:
-                        既存のデータを更新するクエリ。通常は <acronym>SQL</acronym> の UPDATE。
+                        既存のデータを更新するクエリ。通常は <acronym>SQL</acronym> の <acronym>UPDATE</acronym>。
                     </para>
                 </listitem>
                 <listitem>
                     <para>
                         <constant>Zend_Db_Profiler::DELETE</constant>:
-                        既存のデータを削除するクエリ。通常は <acronym>SQL</acronym> の DELETE。
+                        既存のデータを削除するクエリ。通常は <acronym>SQL</acronym> の <acronym>DELETE</acronym>。
                     </para>
                 </listitem>
                 <listitem>
                     <para>
                         <constant>Zend_Db_Profiler::SELECT</constant>:
-                        既存のデータを取得するクエリ。通常は <acronym>SQL</acronym> の SELECT。
+                        既存のデータを取得するクエリ。通常は <acronym>SQL</acronym> の <acronym>SELECT</acronym>。
                     </para>
                 </listitem>
                 <listitem>