Browse Source

[DOCUMENTATION]Japanese sync

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@21226 44c647ce-9c0f-0410-b52a-842ac1e357ba
yoshida@zend.co.jp 16 years ago
parent
commit
4135a7a633

+ 81 - 16
documentation/manual/ja/module_specs/Zend_Db_Adapter.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19173 -->
+<!-- EN-Revision: 21080 -->
 <sect1 id="zend.db.adapter">
 
     <title>Zend_Db_Adapter</title>
@@ -739,6 +739,7 @@ echo $result[0]->bug_description;
             <para>
                 <methodname>fetchAssoc()</methodname> メソッドは、
                 フェッチモードの設定にかかわらず、
+                最初のカラムを配列のインデックスとして使って、
                 結果のデータを連想配列の配列で返します。
             </para>
 
@@ -747,10 +748,11 @@ echo $result[0]->bug_description;
                 <programlisting language="php"><![CDATA[
 $db->setFetchMode(Zend_Db::FETCH_OBJ);
 
-$result = $db->fetchAssoc('SELECT * FROM bugs WHERE bug_id = ?', 2);
+$result = $db->fetchAssoc('SELECT bug_id, bug_description, bug_status FROM bugs');
 
 // $result は、フェッチモードの指定とは関係なく連想配列の配列となります
-echo $result[0]['bug_description'];
+echo $result[2]['bug_description']; // Description of Bug #2
+echo $result[1]['bug_description']; // Description of Bug #1
 ]]></programlisting>
             </example>
 
@@ -902,7 +904,7 @@ $db->insert('bugs', $data);
                 データの配列で指定しなかったカラムについてはデータベースに対して何も指示しません。
                 つまり、<acronym>SQL</acronym> の <acronym>INSERT</acronym> 文で列を指定しなかった場合と同じ挙動となります。
                 <acronym>DEFAULT</acronym> 句が設定されていればその値が追加され、
-                設定されていなければ <acronym>NULL</acronym> のままとなります。
+                設定されていなければ <constant>NULL</constant> のままとなります。
             </para>
 
             <para>
@@ -1596,7 +1598,8 @@ try {
                     <row>
                         <entry><constant>NULLABLE</constant></entry>
                         <entry>(boolean)</entry>
-                        <entry>そのカラムが <acronym>SQL</acronym> の NULL を許可している場合は true、NOT NULL 制約が指定されている場合は false。</entry>
+                        <entry>そのカラムが <acronym>SQL</acronym> の <constant>NULL</constant> を許可している場合は <constant>TRUE</constant> 、
+                        <constant>NOT</constant> <constant>NULL</constant> 制約が指定されている場合は <constant>FALSE</constant>。</entry>
                     </row>
                     <row>
                         <entry><constant>LENGTH</constant></entry>
@@ -1616,12 +1619,12 @@ try {
                     <row>
                         <entry><constant>UNSIGNED</constant></entry>
                         <entry>(boolean)</entry>
-                        <entry>整数系の型で、符号なし (<constant>UNSIGNED</constant>) である場合に true。</entry>
+                        <entry>整数系の型で、符号なし (<constant>UNSIGNED</constant>) である場合に <constant>TRUE</constant>。</entry>
                     </row>
                     <row>
                         <entry><constant>PRIMARY</constant></entry>
                         <entry>(boolean)</entry>
-                        <entry>そのカラムが主キーの一部である場合に true。</entry>
+                        <entry>そのカラムが主キーの一部である場合に <constant>TRUE</constant>。</entry>
                     </row>
                     <row>
                         <entry><constant>PRIMARY_POSITION</constant></entry>
@@ -1631,7 +1634,7 @@ try {
                     <row>
                         <entry><constant>IDENTITY</constant></entry>
                         <entry>(boolean)</entry>
-                        <entry>そのカラムが自動生成の値を使用している場合に true。</entry>
+                        <entry>そのカラムが自動生成の値を使用している場合に <constant>TRUE</constant>。</entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -1718,11 +1721,12 @@ $db->closeConnection();
             <para>
                 はい。<classname>Zend_Db</classname> のアダプタの設定
                 (driver_configuration ではありません) で、
-                <property>persistent</property> フラグを true に設定することで対応します。
+                <property>persistent</property> フラグを <constant>TRUE</constant> に設定することで対応します。
             </para>
 
             <example id="zend.db.adapter.connecting.persistence.example">
                 <title>Oracle アダプタでの持続的接続の使用</title>
+
                 <programlisting language="php"><![CDATA[
 $db = Zend_Db::factory('Oracle', array(
     'host'       => '127.0.0.1',
@@ -1739,6 +1743,7 @@ $db = Zend_Db::factory('Oracle', array(
                 接続作成時のオーバーヘッドが減ることによるパフォーマンスの向上よりも、
                 それによって引き起こされる問題のほうが多くなりえます。
             </para>
+
             <para>
                 データベース接続は、その状態を管理しています。
                 つまり、<acronym>RDBMS</acronym> サーバのオブジェクトの中には
@@ -1750,6 +1755,7 @@ $db = Zend_Db::factory('Oracle', array(
                 別の <acronym>PHP</acronym> リクエストが作成したデータに
                 誤ってアクセスしてしまう危険が生じてしまいます。
             </para>
+
             <para>
                 現在、<classname>Zend_Db</classname> が持続的接続をサポートしているのは
                 Oracle、DB2 そして <acronym>PDO</acronym> アダプタ
@@ -1794,6 +1800,7 @@ $db = Zend_Db::factory('Oracle', array(
 
         <example id="zend.db.adapter.other-statements.example">
             <title>PDO アダプタによる、プリペアド形式ではないクエリの実行</title>
+
             <programlisting language="php"><![CDATA[
 $result = $db->getConnection()->exec('DROP TABLE bugs');
 ]]></programlisting>
@@ -1827,6 +1834,7 @@ $result = $db->getConnection()->exec('DROP TABLE bugs');
 
         <example id="zend.db.adapter.server-version.example">
             <title>サーバのバージョンを取得してからクエリを実行する</title>
+
             <programlisting language="php"><![CDATA[
 $version = $db->getServerVersion();
 if (!is_null($version)) {
@@ -1853,6 +1861,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.ibm-db2">
             <title>IBM DB2</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -1860,11 +1869,13 @@ if (!is_null($version)) {
                         'Db2' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の ibm_db2 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         IBM DB2 は、シーケンスも自動インクリメントのキーも
@@ -1882,6 +1893,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.mysqli">
             <title>MySQLi</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -1889,11 +1901,13 @@ if (!is_null($version)) {
                         名前を 'Mysqli' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の mysqli 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         MySQL はシーケンスをサポートしていません。したがって、
@@ -1908,6 +1922,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.oracle">
             <title>Oracle</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -1915,11 +1930,13 @@ if (!is_null($version)) {
                         名前を 'Oracle' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の oci8 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Oracle は自動インクリメントのキーをサポートしていません。
@@ -1928,12 +1945,14 @@ if (!is_null($version)) {
                         にはシーケンス名を指定する必要があります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Oracle 拡張モジュールは位置指定によるパラメータをサポートしていません。
                         名前つきパラメータを使用する必要があります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         現在、Oracle アダプタでは <constant>Zend_Db::CASE_FOLDING</constant>
@@ -1942,6 +1961,7 @@ if (!is_null($version)) {
                         アダプタを使用する必要があります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         デフォルトでは、LOB フィールドは OCI-Lob オブジェクトで返されます。
@@ -1956,6 +1976,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.sqlsrv">
             <title>Microsoft SQL Server</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -1963,11 +1984,13 @@ if (!is_null($version)) {
                         名前を 'Sqlsrv' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の sqlsrv 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Microsoft <acronym>SQL</acronym> Server はシーケンスをサポートしていません。
@@ -1978,6 +2001,7 @@ if (!is_null($version)) {
                         <constant>NULL</constant> となります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <classname>Zend_Db_Adapter_Sqlsrv</classname> は、
@@ -1990,14 +2014,16 @@ if (!is_null($version)) {
                         それは使わないようになります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         オプション配列のキーに <property>driver_options</property>
                         を指定できます。この値は <ulink
-                            url="http://msdn.microsoft.com/en-us/library/cc296161(SQL.90).aspx">http://msdn.microsoft.com/en-us/library/cc296161(SQL.90).aspx</ulink>
+                            url="http://msdn.microsoft.com/ja-jp/library/cc296161(SQL.90).aspx">http://msdn.microsoft.com/ja-jp/library/cc296161(SQL.90).aspx</ulink>
                         に書かれているものとなります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <methodname>setTransactionIsolationLevel()</methodname>
@@ -2009,6 +2035,7 @@ if (!is_null($version)) {
                         <constant>SQLSRV_TXN_SERIALIZABLE</constant> のいずれかとなります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Zend Framework 1.9 以降は、Microsoft の
@@ -2022,6 +2049,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-ibm">
             <title>PDO for IBM DB2 and Informix Dynamic Server (IDS)</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2029,11 +2057,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Ibm</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_ibm 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         PDO_IBM 拡張モジュールのバージョン 1.2.2 以降が必要です。
@@ -2046,6 +2076,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-mssql">
             <title>PDO Microsoft SQL Server</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2053,11 +2084,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Mssql</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_dblib 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Microsoft SQL Server はシーケンスをサポートしていません。
@@ -2068,6 +2101,7 @@ if (!is_null($version)) {
                         <constant>NULL</constant> となります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         unicode 文字列を UCS-2 以外のエンコーディング (UTF-8 など)
@@ -2078,6 +2112,7 @@ if (!is_null($version)) {
                         を参照ください。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <classname>Zend_Db_Adapter_Pdo_Mssql</classname> は、SQL Server
@@ -2087,6 +2122,7 @@ if (!is_null($version)) {
                         SQL Server の独自仕様である角括弧によるクォートは使用しません。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         オプションの配列で、キーとして <property>pdoType</property>
@@ -2109,6 +2145,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-mysql">
             <title>PDO MySQL</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2116,11 +2153,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Mysql</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_mysql 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         MySQL はシーケンスをサポートしていません。したがって、
@@ -2135,6 +2174,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-oci">
             <title>PDO Oracle</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2142,11 +2182,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Oci</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_oci 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Oracle は自動インクリメントのキーをサポートしていません。
@@ -2160,6 +2202,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-pgsql">
             <title>PDO PostgreSQL</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2167,11 +2210,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Pgsql</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_pgsql 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         PostgreSQL は、シーケンスも自動インクリメントのキーも
@@ -2189,6 +2234,7 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.pdo-sqlite">
             <title>PDO SQLite</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
@@ -2196,11 +2242,13 @@ if (!is_null($version)) {
                         名前を '<classname>Pdo_Sqlite</classname>' とします。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の pdo および pdo_sqlite 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         SQLite はシーケンスをサポートしていません。したがって、
@@ -2210,6 +2258,7 @@ if (!is_null($version)) {
                         <constant>NULL</constant> となります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         SQLite2 データベースに接続するには、
@@ -2218,6 +2267,7 @@ if (!is_null($version)) {
                         <command>'sqlite2' => true</command> を指定します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         メモリ上の SQLite データベースに接続するには、
@@ -2226,6 +2276,7 @@ if (!is_null($version)) {
                         <command>'dbname' => ':memory:'</command> を指定します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <acronym>PHP</acronym> 用の SQLite ドライバの古いバージョンでは、
@@ -2241,12 +2292,14 @@ if (!is_null($version)) {
 
         <sect3 id="zend.db.adapter.adapter-notes.firebird">
             <title>Firebird/Interbase</title>
+
             <itemizedlist>
                 <listitem>
                     <para>
                         このアダプタは、<acronym>PHP</acronym> の php_interbase 拡張モジュールを使用します。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         Firebird/interbase は自動インクリメントのキーをサポートしていません。
@@ -2255,6 +2308,7 @@ if (!is_null($version)) {
                         <methodname>lastSequenceId()</methodname> に指定する必要があります。
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         現在、Firebird/interbase アダプタでは <constant>Zend_Db::CASE_FOLDING</constant>
@@ -2264,12 +2318,23 @@ if (!is_null($version)) {
                 </listitem>
 
                 <listitem>
-                    <para>アダプタ名は <classname>ZendX_Db_Adapter_Firebird</classname> です。</para>
-                    <para>パラメータ adapterNamespace の値を <classname>ZendX_Db_Adapter</classname> とすることを覚えておきましょう。</para>
-                    <para>php にバンドルされている <filename>gds32.dll</filename> (あるいは linux 環境でそれに相当するもの) をアップデートし、
-                    サーバと同じバージョンにしておくことを推奨します。
-                    Firebird で <filename>gds32.dll</filename> に相当するものは <filename>fbclient.dll</filename> です。</para>
-                    <para>デフォルトでは、すべての識別子 (テーブル名やフィールド) は大文字で返されます。</para>
+                    <para>
+                        アダプタ名は <classname>ZendX_Db_Adapter_Firebird</classname> です。
+                    </para>
+
+                    <para>
+                        パラメータ adapterNamespace の値を <classname>ZendX_Db_Adapter</classname> とすることを覚えておきましょう。
+                    </para>
+
+                    <para>
+                        php にバンドルされている <filename>gds32.dll</filename> (あるいは linux 環境でそれに相当するもの) をアップデートし、
+                        サーバと同じバージョンにしておくことを推奨します。
+                        Firebird で <filename>gds32.dll</filename> に相当するものは <filename>fbclient.dll</filename> です。
+                    </para>
+
+                    <para>
+                        デフォルトでは、すべての識別子 (テーブル名やフィールド) は大文字で返されます。
+                    </para>
                 </listitem>
             </itemizedlist>
         </sect3>

+ 22 - 16
documentation/manual/ja/module_specs/Zend_Db_Profiler-Firebug.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17600 -->
+<!-- EN-Revision: 20766 -->
 <sect3 id="zend.db.profiler.profilers.firebug">
     <title>Firebug によるプロファイリング</title>
 
@@ -24,21 +24,27 @@
     </para>
 
     <itemizedlist>
-        <listitem><para>
-            Firefox ブラウザ。バージョン 3 が最適ですがバージョン 2 にも対応しています。
-        </para></listitem>
-
-        <listitem> <para>
-            Firebug 拡張。<ulink
-                url="https://addons.mozilla.org/en-US/firefox/addon/1843">https://addons.mozilla.org/en-US/firefox/addon/1843</ulink>
-            からダウンロードできます。
-        </para></listitem>
-
-        <listitem><para>
-            FirePHP 拡張。<ulink
-                url="https://addons.mozilla.org/en-US/firefox/addon/6149">https://addons.mozilla.org/en-US/firefox/addon/6149</ulink>
-            からダウンロードできます。
-        </para></listitem>
+        <listitem>
+            <para>
+                Firefox ブラウザ。バージョン 3 が最適ですがバージョン 2 にも対応しています。
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Firebug 拡張。<ulink
+                    url="https://addons.mozilla.org/ja/firefox/addon/1843">https://addons.mozilla.org/ja/firefox/addon/1843</ulink>
+                からダウンロードできます。
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                FirePHP 拡張。<ulink
+                    url="https://addons.mozilla.org/ja/firefox/addon/6149">https://addons.mozilla.org/ja/firefox/addon/6149</ulink>
+                からダウンロードできます。
+            </para>
+        </listitem>
     </itemizedlist>
 
     <example id="zend.db.profiler.profilers.firebug.example.with_front_controller">

+ 20 - 9
documentation/manual/ja/module_specs/Zend_Filter-Decryption.xml

@@ -1,25 +1,25 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19150 -->
+<!-- EN-Revision: 21212 -->
 <sect2 id="zend.filter.set.decrypt">
     <title>Decrypt</title>
     <para>
         このフィルタは、指定した文字列を指定した設定で復号します。
         復号の際に、アダプタを使用します。実際には、PHP の
-        <code>Mcrypt</code> および <code>OpenSSL</code>
+        <classname>Mcrypt</classname> および <classname>OpenSSL</classname>
         拡張モジュール用のアダプタを使用します。
     </para>
 
     <para>
-        コンテンツの暗号化方法の詳細については <code>Encrypt</code> フィルタを参照ください。
-        基本的な内容は <code>Encrypt</code> フィルタで網羅されているので、
+        コンテンツの暗号化方法の詳細については <classname>Encrypt</classname> フィルタを参照ください。
+        基本的な内容は <classname>Encrypt</classname> フィルタで網羅されているので、
         ここでは追加のメソッドや復号時に固有のことなどについてのみ説明します。
     </para>
 
     <sect3 id="zend.filter.set.decrypt.mcrypt">
         <title>Mcrypt の復号</title>
         <para>
-            <code>Mcrypt</code> で暗号化したコンテンツを復号するには、
+            <classname>Mcrypt</classname> で暗号化したコンテンツを復号するには、
             暗号化を行った際に指定したオプションが必要です。
         </para>
 
@@ -53,7 +53,7 @@ print $decrypted;
 
         <note>
             <para>
-                また、インスタンス作成時あるいは setEncryption()
+                また、インスタンス作成時あるいは <methodname>setEncryption()</methodname>
                 をコールした際にすべての設定がチェックされることにも注意しましょう。
                 設定内容に問題があることを mcrypt が検知すると、例外がスローされます。
             </para>
@@ -63,12 +63,12 @@ print $decrypted;
     <sect3 id="zend.filter.set.decrypt.openssl">
         <title>OpenSSL の復号</title>
         <para>
-            <code>OpenSSL</code> での復号は、暗号化と同様にシンプルです。
+            <classname>OpenSSL</classname> での復号は、暗号化と同様にシンプルです。
             しかし、コンテンツを暗号化した人からすべてのデータを受け取る必要があります。
         </para>
 
         <para>
-            <code>OpenSSL</code> の復号には、以下が必要となります。
+            <classname>OpenSSL</classname> の復号には、以下が必要となります。
         </para>
 
         <itemizedlist>
@@ -86,6 +86,17 @@ print $decrypted;
                     暗号化されたエンベロープ鍵。
                     鍵ファイルのパスとファイル名を指定するか、
                     あるいは単に鍵ファイルの内容そのものを指定することもできます。
+                    <!-- TODO : to be translated -->
+                    When the
+                    <property>package</property> option has been set, then you can omit this
+                    parameter.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>package</emphasis>: If the envelope key has been packed with the
+                    encrypted value. Defaults to <constant>FALSE</constant>.
                 </para>
             </listitem>
         </itemizedlist>
@@ -106,7 +117,7 @@ $filter->setEnvelopeKey(array(
 
         <note>
             <para>
-                <code>OpenSSL</code> アダプタは、正しい鍵を渡さないと動作しないことに注意しましょう。
+                <classname>OpenSSL</classname> アダプタは、正しい鍵を渡さないと動作しないことに注意しましょう。
             </para>
         </note>
 

+ 112 - 1
documentation/manual/ja/module_specs/Zend_Filter-Encryption.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 21212 -->
 <sect2 id="zend.filter.set.encrypt">
     <title>Encrypt</title>
+
     <para>
         このフィルタは、指定した設定で任意の文字列を暗号化します。
         暗号化の際に、アダプタを使用します。実際には、PHP の
@@ -46,6 +47,7 @@ $filter->setAdapter('openssl');
 
     <sect3 id="zend.filter.set.encrypt.mcrypt">
         <title>Mcrypt での暗号化</title>
+
         <para>
             <code>Mcrypt</code> 拡張モジュールをインストールすると、
             <code>Mcrypt</code> アダプタが使えるようになります。
@@ -111,6 +113,16 @@ $filter->setAdapter('openssl');
                     デフォルトは <constant>FALSE</constant> です。
                 </para>
             </listitem>
+
+            <!-- TODO : to be translated -->
+            <listitem>
+                <para>
+                    <emphasis>compression</emphasis>: If the encrypted value should be compressed.
+                    Default is no compression. For details take a look into <link
+                        linkend="zend.filter.set.encrypt.openssl.compressed">compression for
+                        Openssl</link>.
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -169,6 +181,7 @@ print $encrypted;
 
     <sect3 id="zend.filter.set.encrypt.openssl">
         <title>OpenSSL での暗号化</title>
+
         <para>
             <code>OpenSSL</code> 拡張モジュールをインストールすると、
             <code>OpenSSL</code> アダプタが使えるようになります。
@@ -192,6 +205,21 @@ print $encrypted;
                     あるいは単に鍵ファイルの内容そのものを指定することもできます。
                 </para>
             </listitem>
+
+            <!-- TODO : to be translated -->
+            <listitem>
+                <para>
+                    <emphasis>compression</emphasis>: If the encrypted value should be compressed.
+                    Default is no compression.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>package</emphasis>: If the envelope key should be packed with the
+                    encrypted value. Default is <constant>FALSE</constant>.
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>
@@ -278,6 +306,89 @@ print $encrypted;
 
 // 復号の方法は Decrypt フィルタを参照ください
 ]]></programlisting>
+
+        <!-- TODO : to be translated -->
+        <sect4 id="zend.filter.set.encrypt.openssl.simplified">
+            <title>Simplified usage with Openssl</title>
+
+            <para>
+                As seen before, you need to get the envelope key to be able to decrypt the previous
+                encrypted value. This can be very annoying when you work with multiple values.
+            </para>
+
+            <para>
+                To have a simplified usage you can set the <property>package</property> option to
+                <constant>TRUE</constant>. The default value is <constant>FALSE</constant>.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Use openssl and provide a private key
+$filter = new Zend_Filter_Encrypt(array(
+    'adapter' => 'openssl',
+    'private' => '/path/to/mykey/private.pem',
+    'public'  => '/public/key/path/public.pem',
+    'package' => true
+));
+
+$encrypted = $filter->filter('text_to_be_encoded');
+print $encrypted;
+
+// For decryption look at the Decrypt filter
+]]></programlisting>
+
+            <para>
+                Now the returned value contains the encrypted value and the envelope. You don't
+                need to get them after the compression. But, and this is the negative aspect of
+                this feature, the encrypted value can now only be decrypted by using
+                <classname>Zend_Filter_Encrypt</classname>.
+            </para>
+        </sect4>
+
+        <sect4 id="zend.filter.set.encrypt.openssl.compressed">
+            <title>Compressing the content</title>
+
+            <para>
+                Based on the original value, the encrypted value can be a very large string. To
+                reduce the value <classname>Zend_Filter_Encrypt</classname> allows the usage of
+                compression.
+            </para>
+
+            <para>
+                The <property>compression</property> option can eighter be set to the name of a
+                compression adapter, or to an array which sets all wished options for the
+                compression adapter.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Use basic compression adapter
+$filter1 = new Zend_Filter_Encrypt(array(
+    'adapter'     => 'openssl',
+    'private'     => '/path/to/mykey/private.pem',
+    'public'      => '/public/key/path/public.pem',
+    'package'     => true,
+    'compression' => 'bz2'
+));
+
+// Use basic compression adapter
+$filter2 = new Zend_Filter_Encrypt(array(
+    'adapter'     => 'openssl',
+    'private'     => '/path/to/mykey/private.pem',
+    'public'      => '/public/key/path/public.pem',
+    'package'     => true,
+    'compression' => array('adapter' => 'zip', 'target' => '\usr\tmp\tmp.zip')
+));
+]]></programlisting>
+
+            <note>
+                <title>Decryption with same settings</title>
+
+                <para>
+                    When you want to decrypt a value which is additionally compressed, then you
+                    need to set the same compression settings for decryption as for encryption.
+                    Otherwise the decryption will fail.
+                </para>
+            </note>
+        </sect4>
     </sect3>
 </sect2>
 

+ 1 - 1
documentation/manual/ja/module_specs/Zend_Filter-LocalizedToNormalized.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17969 -->
+<!-- EN-Revision: 20774 -->
 <sect2 id="zend.filter.set.localizedtonormalized">
 
     <title>LocalizedToNormalized</title>

+ 1 - 1
documentation/manual/ja/module_specs/Zend_Filter-NormalizedToLocalized.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15854 -->
+<!-- EN-Revision: 20774 -->
 <sect2 id="zend.filter.set.normalizedtolocalized">
 
     <title>NormalizedToLocalized</title>

+ 4 - 4
documentation/manual/ja/module_specs/Zend_Log-Writers-Firebug.xml

@@ -31,14 +31,14 @@
       <listitem>
         <para>
           Firebug 拡張。
-          <ulink url="https://addons.mozilla.org/en-US/firefox/addon/1843">https://addons.mozilla.org/en-US/firefox/addon/1843</ulink>
+          <ulink url="https://addons.mozilla.org/ja/firefox/addon/1843">https://addons.mozilla.org/ja/firefox/addon/1843</ulink>
           からダウンロードできます。
         </para>
       </listitem>
       <listitem>
         <para>
           FirePHP 拡張。
-          <ulink url="https://addons.mozilla.org/en-US/firefox/addon/6149">https://addons.mozilla.org/en-US/firefox/addon/6149</ulink>
+          <ulink url="https://addons.mozilla.org/ja/firefox/addon/6149">https://addons.mozilla.org/ja/firefox/addon/6149</ulink>
           からダウンロードできます。
         </para>
       </listitem>
@@ -154,7 +154,7 @@ $writer->setDefaultPriorityStyle('TRACE');
       <title>ログ記録用のデータの準備</title>
 
       <para>
-        任意の <acronym>PHP</acronym> の変数を組み込みの優先度でログに記録することができますが、
+        任意の <acronym>PHP</acronym> の変数を組み込みの優先度でログに記録できますが、
         特殊なログ形式を使う場合は、何らかの書式変換が必要となります。
       </para>
       <para>
@@ -184,7 +184,7 @@ $logger->err($exception);
       <title>表形式のログ</title>
 
       <para>
-        ログを表形式で記録することができます。カラムは自動検出され、
+        ログを表形式で記録できます。カラムは自動検出され、
         データの最初の行がヘッダと見なされます。
       </para>
       <programlisting language="php"><![CDATA[

+ 6 - 6
documentation/manual/ja/module_specs/Zend_Mail_Read.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 21109 -->
 <sect1 id="zend.mail.read">
     <title>メールメッセージの読み込み</title>
 
@@ -8,7 +8,7 @@
         <classname>Zend_Mail</classname> を使用すると、
         ローカルあるいはリモートに保存されたメールを読み込むことができます。
         すべての保存形式に共通の基本 <acronym>API</acronym> では、メッセージ数を数えたり
-        メッセージを読み込んだりすることができます。また、
+        メッセージを読み込んだりできます。また、
         いくつかの保存形式では、特殊な追加機能も実装されています。
         各保存形式で実装されている機能の概要については以下の表を参照ください。
     </para>
@@ -186,7 +186,7 @@ $mail = new Zend_Mail_Storage_Pop3(array('host'     => 'example.com',
         <title>メッセージの取得およびシンプルなメソッド</title>
 
         <para>
-            ストレージをオープンしたら、メッセージを取得することができます。
+            ストレージをオープンしたら、メッセージを取得できます。
             メッセージを取得するには、メッセージ番号が必要です。
             これは、最初のメッセージを 1 番とする連番となります。
             メッセージを取得する際に使用するメソッドは <methodname>getMessage()</methodname> です。
@@ -380,7 +380,7 @@ if (!$foundPart) {
         <classname>Zend_Mail_Storage::FLAG_&lt;flagname&gt;</classname> という名前です。
         フラグをチェックするには、<classname>Zend_Mail_Message</classname>
         の <methodname>hasFlag()</methodname> メソッドを使用します。
-        <methodname>getFlags()</methodname> で、設定されているすべてのフラグを取得することができます。</para>
+        <methodname>getFlags()</methodname> で、設定されているすべてのフラグを取得できます。</para>
 
         <programlisting language="php"><![CDATA[
 // 未読メッセージを探します
@@ -420,7 +420,7 @@ foreach ($flags as $flag) {
 }
 ]]></programlisting>
 
-        <para>IMAP ではユーザやクライアントが独自にフラグを設定することができます。
+        <para>IMAP ではユーザやクライアントが独自にフラグを設定できます。
         <classname>Zend_Mail_Storage</classname> で定数が定義されていない、
         このようなフラグを取得することも可能です。これらは文字列として返され、
         <methodname>hasFlag()</methodname> で同じようにチェックできます。</para>
@@ -619,7 +619,7 @@ foreach ($mail as $message) {
             難点があるとすれば、Mbox や Maildir を変更することができなくなるということです。
             簡単な解決策としては、最終更新時刻が変更されたときに Mbox ファイルをパースしなおしたり、
             フォルダがなくなった場合にフォルダ構造を再パースしたり
-            (これはエラーとなりますが、その後別のフォルダを検索することができます)
+            (これはエラーとなりますが、その後別のフォルダを検索できます)
             といったことが考えられます。よりよい方法は、シグナルファイル的なものを用意して
             変更情報をそこに記録し、まずそれをチェックしてからキャッシュを利用するようにすることです。
             </para>

+ 1 - 1
documentation/manual/ja/module_specs/Zend_Navigation-Pages-Factory.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20827 -->
 <sect2 id="zend.navigation.pages.factory">
     <title>ページ・ファクトリを使ってページを作成</title>
 

+ 4 - 1
documentation/manual/ja/module_specs/Zend_Navigation-Pages-URI.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20827 -->
 <sect2 id="zend.navigation.pages.uri">
     <title>Zend_Navigation_Page_Uri</title>
 
@@ -28,6 +28,7 @@
 
     <table id="zend.navigation.pages.uri.options">
         <title>URI画面のオプション</title>
+
         <tgroup cols="4">
             <thead>
                 <row>
@@ -37,11 +38,13 @@
                     <entry>説明</entry>
                 </row>
             </thead>
+
             <tbody>
                 <row>
                     <entry><code>uri</code></entry>
                     <entry><type>String</type></entry>
                     <entry><constant>NULL</constant></entry>
+
                     <entry>
                         画面への<acronym>URI</acronym>。さまざまな文字列または <constant>NULL</constant> になりうる。
                     </entry>

+ 6 - 4
documentation/manual/ja/module_specs/Zend_XmlRpc_Server.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20818 -->
 <sect1 id="zend.xmlrpc.server">
     <title>Zend_XmlRpc_Server</title>
 
@@ -118,6 +118,7 @@ echo $server->handle();
 
     <sect2 id="zend.xmlrpc.server.conventions">
         <title>規約</title>
+
         <para>
             <classname>Zend_XmlRpc_Server</classname> では、開発者が関数やクラスメソッドを
             <acronym>XML-RPC</acronym> メソッドとしてアタッチできるようになっています。
@@ -450,9 +451,10 @@ $server->setClass('Services_PricingService',
 ]]></programlisting>
 
             <para>
-                The arguments passed at <methodname>setClass()</methodname> at server construction time are
-                injected into the method call <command>pricing.calculate()</command> on remote invokation.
-                In the example above, only the argument <code>$purchaseId</code> is expected from the client.
+                The arguments passed at <methodname>setClass()</methodname> at server construction
+                time are injected into the method call <command>pricing.calculate()</command> on
+                remote invokation. In the example above, only the argument <code>$purchaseId</code>
+                is expected from the client.
             </para>
         </example>
 

+ 48 - 1
documentation/manual/ja/ref/coding_standard.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20876 -->
+<!-- EN-Revision: 21161 -->
 <appendix id="coding-standard">
     <title>Zend Framework PHP 標準コーディング規約</title>
     <sect1 id="coding-standard.overview">
@@ -188,6 +188,50 @@
                     それより前のバージョンではこの規約に従っていないものもあるかもしれませんが、
                     将来のバージョンでは規約に従うよう名前が変わる予定です。
                 </para>
+
+                <!-- TODO : to be translated -->
+                <para>
+                    The rationale for the change is due to namespace usage. As we look towards Zend
+                    Framework 2.0 and usage of PHP 5.3, we will be using namespaces. The easiest way
+                    to automate conversion to namespaces is to simply convert underscores to the
+                    namespace separator -- but under the old naming conventions, this leaves the
+                    classname as simply "Abstract" or "Interface" -- both of which are reserved
+                    keywords in PHP. If we prepend the (sub)component name to the classname, we can
+                    avoid these issues.
+                </para>
+
+                <para>
+                    To illustrate the situation, consider converting the class
+                    <classname>Zend_Controller_Request_Abstract</classname> to use namespaces:
+                </para>
+
+                <programlisting language="php"><![CDATA[
+namespace Zend\Controller\Request;
+
+abstract class Abstract
+{
+    // ...
+}
+]]></programlisting>
+
+                <para>
+                    Clearly, this will not work. Under the new naming conventions, however, this
+                    would become:
+                </para>
+
+                <programlisting language="php"><![CDATA[
+namespace Zend\Controller\Request;
+
+abstract class RequestAbstract
+{
+    // ...
+}
+]]></programlisting>
+
+                <para>
+                    We still retain the semantics and namespace separation, while omitting the
+                    keyword issues; simultaneously, it better describes the abstract class.
+                </para>
             </note>
         </sect2>
 
@@ -216,6 +260,9 @@
                     この命名規約が適用されるのは、Zend Framework 1.9.0 以降です。
                     それより前のバージョンではこの規約に従っていないものもあるかもしれませんが、
                     将来のバージョンでは規約に従うよう名前が変わる予定です。
+                    この変更に関連する詳細については<link
+                        linkend="coding-standard.naming-conventions.abstracts">前節</link>
+                    をご覧ください。
                 </para>
             </note>
         </sect2>