[DOCUMENTATION]Japanese sync and add Zend_Exception-Previous. Thanks to Sasezaki

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

documentation/manual/ja/module_specs/Zend_Controller-ActionHelpers.xml

@@ -1,15 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16507 -->
+<!-- EN-Revision: 20765 -->
 <sect1 id="zend.controller.actionhelpers" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>アクションヘルパー</title>
 
     <sect2 id="zend.controller.actionhelper.introduction">
         <title>導入</title>
+
         <para>
             アクションヘルパーを使用すると、<classname>Zend_Controller_Action</classname>
             を継承した任意のアクションコントローラに対して
-            実行時やその他必要に応じて機能追加をすることができます。
+            実行時やその他必要に応じて機能を追加できます。
             アクションヘルパーの狙いは、
             アクションコントローラに共通機能を追加するために
             いちいち抽象クラスを継承する手間を省くことにあります。
@@ -103,7 +104,7 @@ $this->_helper->FlashMessenger('先ほどのリクエストで、あることを
         <para>
             <classname>Zend_Controller_Action_HelperBroker</classname>
             がヘルパーオブジェクトやそのパスの登録に関する詳細を処理します。
-            また、必要に応じてそこからヘルパーを取得することができます。
+            また、必要に応じてそこからヘルパーを取得できます。
         </para>
 
         <para>
@@ -154,7 +155,7 @@ Zend_Controller_Action_HelperBroker::addPath('./Plugins/Helpers',
         </itemizedlist>
 
         <para>
-            これらは静的メソッドなので、コントローラチェイン内の任意の場所で使用することができます。
+            これらは静的メソッドなので、コントローラチェイン内の任意の場所で使用できます。
             これにより、必要に応じて動的にヘルパーを追加できることになります。
         </para>
 
@@ -335,7 +336,7 @@ if (Zend_Controller_Action_HelperBroker::hasHelper('redirector')) {
             たとえば、<link
                 linkend="zend.controller.actionhelpers.redirector">redirector</link>
             の <methodname>direct()</methodname> は <methodname>goto()</methodname>
-            のエイリアスとなっているので、このようにして使用することができます。
+            のエイリアスとなっているので、このようにして使用できます。
         </para>
 
         <programlisting language="php"><![CDATA[

documentation/manual/ja/module_specs/Zend_Controller-Plugins.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16705 -->
+<!-- EN-Revision: 20765 -->
 <sect1 id="zend.controller.plugins" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>プラグイン</title>
 
@@ -9,7 +9,7 @@
 
         <para>
             コントローラにはプラグイン機構が組み込まれており、
-            コントローラの処理中にイベントが発生した際にユーザのコードをコールすることができます。
+            コントローラの処理中にイベントが発生した際にユーザのコードをコールできます。
             フロントコントローラは、プラグインブローカにユーザのプラグインを登録します。
             そして、イベントメソッドがコールされた際に、
             フロントコントローラに登録されているプラグインをプラグインブローカが実行します。
@@ -52,7 +52,7 @@
                     このコールバックは、プロキシやフィルタ的な動作をさせることができます。
                     リクエストの内容を変更してディスパッチフラグをリセット
                     (<methodname>Zend_Controller_Request_Abstract::setDispatched(false)</methodname> を使用します)
-                    することで、現在のアクションをスキップさせたり置き換えたりすることができます。
+                    することで、現在のアクションをスキップさせたり置き換えたりできます。
                 </para>
             </listitem>
 
@@ -63,7 +63,7 @@
                     このコールバックは、プロキシやフィルタ的な動作をさせることができます。
                     リクエストの内容を変更してディスパッチフラグをリセット
                     (<methodname>Zend_Controller_Request_Abstract::setDispatched(false)</methodname> を使用します)
-                    することで、新しいディスパッチ先アクションを指定することができます。
+                    することで、新しいディスパッチ先アクションを指定できます。
                 </para>
             </listitem>
 
@@ -96,12 +96,12 @@ class MyPlugin extends Zend_Controller_Plugin_Abstract
             <classname>Zend_Controller_Plugin_Abstract</classname> には抽象メソッドはありません。
             つまり、上に示したイベントメソッドを、
             プラグインクラスでかならず実装しなければならないわけではありません。
-            プラグインの作者が、必要なものだけを選んで実装することができます。
+            プラグインの作者が、必要なものだけを選んで実装できます。
         </para>
 
         <para>
             <classname>Zend_Controller_Plugin_Abstract</classname> では、
-            リクエストオブジェクトやレスポンスオブジェクトをプラグインから操作することができます。
+            リクエストオブジェクトやレスポンスオブジェクトをプラグインから操作できます。
             それぞれ、<methodname>getRequest()</methodname> メソッドおよび
             <methodname>getResponse()</methodname> メソッドを使用します。
         </para>
@@ -180,7 +180,7 @@ $front->dispatch();
 
         <note>
             <para>
-                プラグインは、フロントコントローラの実行時ならいつでも登録することができます。
+                プラグインは、フロントコントローラの実行時ならいつでも登録できます。
                 しかし、プラグインがイベントメソッドを登録しようとしているイベントが終わった後では、
                 そのメソッドは実行されません。
             </para>
@@ -196,23 +196,29 @@ $front->dispatch();
         </para>
 
         <itemizedlist>
-            <listitem><para>
+            <listitem>
+                <para>
                     <methodname>getPlugin($class)</methodname>
                     は、指定したクラス名のプラグインを取得します。
                     一致するプラグインがない場合は <constant>FALSE</constant> を返します。
                     同じクラス名のプラグインが複数登録されている場合は、結果を配列で返します。
-            </para></listitem>
+                </para>
+            </listitem>
 
-            <listitem><para>
+            <listitem>
+                <para>
                     <methodname>getPlugins()</methodname> は、プラグインスタック全体を取得します。
-            </para></listitem>
+                </para>
+            </listitem>
 
-            <listitem><para>
+            <listitem>
+                <para>
                     <methodname>unregisterPlugin($plugin)</methodname>
                     は、プラグインをスタックから登録解除します。
                     パラメータには、プラグインオブジェクト自体かそのクラス名を渡します。
                     クラス名を渡すと、一致するプラグインがすべて削除されます。
-            </para></listitem>
+                </para>
+            </listitem>
         </itemizedlist>
     </sect2>
 

documentation/manual/ja/module_specs/Zend_Dojo-View.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17133 -->
+<!-- EN-Revision: 20766 -->
 <sect1 id="zend.dojo.view" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Dojo ビューヘルパー</title>
 
@@ -9,11 +9,13 @@
     </para>
 
     <itemizedlist>
-        <listitem><para>
-            <emphasis>dojo():</emphasis> Dojo 環境のセットアップ、つまり
-            dojo の設定やカスタムモジュールのパス、モジュールの require 文、
-            テーマのスタイルシート、CDN を使用するか否かなどの指定を行います。
-        </para></listitem>
+        <listitem>
+            <para>
+                <emphasis>dojo():</emphasis> Dojo 環境のセットアップ、つまり
+                dojo の設定やカスタムモジュールのパス、モジュールの require 文、
+                テーマのスタイルシート、 CDN を使用するか否かなどの指定を行います。
+            </para>
+        </listitem>
     </itemizedlist>
 
     <example id="zend.dojo.view.setup">

documentation/manual/ja/module_specs/Zend_Exception-Previous.xml

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 19777 -->
+<sect1 id="zend.exception.previous">
+    <title>Previous Exceptions (前の例外)</title>
+
+    <para>
+        Zend Framework 1.10 から、 <classname>Zend_Exception</classname> は PHP 5.3 がサポートする
+        previous exceptions (前の例外)を実装しています。単に配置するだけで、 <methodname>catch</methodname>
+        節に、元の例外を参照する新しい例外を投げることができ、デバッグの際の追加コンテキスト
+        の提供を助けます。 Zend Framework にてこのサポートを提供することによって、あなたのコードは
+        PHP 5.3 と互換性のあるものへと転換するでしょう。
+    </para>
+
+    <para>
+        Previous exceptions は例外のコンストラクタへの第 3 引数として示されます。
+    </para>
+
+    <example id="zend.exception.previous.example">
+        <title>Previous exceptions (前の例外)</title>
+
+        <programlisting language="php"><![CDATA[
+try {
+    $db->query($sql);
+} catch (Zend_Db_Statement_Exception $e) {
+    if ($e->getPrevious()) {
+        echo '[' . get_class($e)
+            . '] has the previous exception of ['
+            . get_class($e->getPrevious())
+            . ']' . PHP_EOL;
+    } else {
+        echo '[' . get_class($e)
+            . '] does not have a previous exception'
+            . PHP_EOL;
+    }
+
+    echo $e;
+    // 可能な場合、最初の例外で始まる例外を全て表示します。
+}
+]]></programlisting>
+    </example>
+</sect1>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/ja/module_specs/Zend_Log-Filters.xml

@@ -1,21 +1,21 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17133 -->
+<!-- EN-Revision: 20792 -->
 <sect1 id="zend.log.filters">
     <title>フィルタ</title>
 
     <para>
-      フィルタオブジェクトは、ログに書き出されるメッセージをブロックします。
+        フィルタオブジェクトは、ログに書き出されるメッセージをブロックします。
     </para>
 
     <sect2 id="zend.log.filters.all-writers">
-      <title>すべてのライターに対するフィルタリング</title>
+        <title>すべてのライターに対するフィルタリング</title>
 
-      <para>
-        すべてのライターの前にフィルタをかけるには、任意の数のフィルタを
-        <methodname>addFilter()</methodname> メソッドでログオブジェクトに追加します。
+        <para>
+            すべてのライターの前にフィルタをかけるには、任意の数のフィルタを
+            <methodname>addFilter()</methodname> メソッドでログオブジェクトに追加します。
 
-        <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $logger = new Zend_Log();
 
 $writer = new Zend_Log_Writer_Stream('php://output');
@@ -31,19 +31,19 @@ $logger->info('通知メッセージ');
 $logger->emerg('緊急メッセージ');
 ]]></programlisting>
 
-        ログオブジェクトにフィルタを追加すると、
-        すべてのフィルタを通貨したものだけをライターが受け取るようになります。
-      </para>
+            ログオブジェクトにフィルタを追加すると、
+            フィルタを全て通過したものだけをライターが受け取るようになります。
+        </para>
     </sect2>
 
     <sect2 id="zend.log.filters.single-writer">
-      <title>ライターのインスタンスに対するフィルタリング</title>
+        <title>ライターのインスタンスに対するフィルタリング</title>
 
-      <para>
-        特定のライターインスタンスに対してだけフィルタをかけるには、ライターの
-        <code>addFilter</code> メソッドを使用します。
+        <para>
+            特定のライターインスタンスに対してだけフィルタをかけるには、ライターの
+            <code>addFilter</code> メソッドを使用します。
 
-        <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $logger = new Zend_Log();
 
 $writer1 = new Zend_Log_Writer_Stream('/path/to/first/logfile');
@@ -62,6 +62,6 @@ $logger->info('通知メッセージ');
 // 両方のライターに記録されます
 $logger->emerg('緊急メッセージ');
 ]]></programlisting>
-    </para>
-  </sect2>
+        </para>
+    </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Test-PHPUnit.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19568 -->
+<!-- EN-Revision: 20807 -->
 <sect1 id="zend.test.phpunit" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Zend_Test_PHPUnit</title>
 
@@ -22,14 +22,18 @@
         </para>
 
         <itemizedlist>
-            <listitem><para>
+            <listitem>
+                <para>
                 ログインフォームは、未認証のユーザに対しても表示されること。
-            </para></listitem>
+                </para>
+            </listitem>
 
-            <listitem><para>
+            <listitem>
+                <para>
                 ユーザがログインしたら、自分のプロファイルページにリダイレクトされること。
                 そしてプロファイルページには、関連する情報が表示されること。
-            </para></listitem>
+                </para>
+            </listitem>
         </itemizedlist>
 
         <para>

documentation/manual/ja/module_specs/Zend_Validate-Set.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20229 -->
+<!-- EN-Revision: 21047 -->
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
 
     <title>標準のバリデーションクラス群</title>
@@ -11,6 +11,7 @@
 
     <sect2 id="zend.validate.set.alnum">
         <title>Alnum</title>
+
         <para>
             <code>$value</code> がアルファベットおよび数字のみで構成されているときにのみ <constant>TRUE</constant> を返します。
             このバリデータでは、オプションとして空白文字を認めることもできます。
@@ -28,6 +29,7 @@
 
     <sect2 id="zend.validate.set.alpha">
         <title>Alpha</title>
+
         <para>
              <code>$value</code> がアルファベットのみで構成されているときにのみ <constant>TRUE</constant> を返します。
             このバリデータでは、オプションとして空白文字を認めることもできます。
@@ -40,6 +42,7 @@
 
     <sect2 id="zend.validate.set.between">
         <title>Between</title>
+
         <para>
             <code>$value</code> が最小値と最大値の間にある場合にのみ <constant>TRUE</constant> を返します。
             デフォルトでは、両端の値も含めて比較します
@@ -58,10 +61,12 @@
 
     <sect2 id="zend.validate.set.ccnum">
         <title>Ccnum</title>
+
         <para>
             <code>$value</code> が Luhn アルゴリズム (10 で割ったあまりのチェックサム)
             を満たすクレジットカード番号である場合にのみ <constant>TRUE</constant> を返します。
         </para>
+
         <note>
             <para>
                 <classname>Ccnum</classname> バリデータは、
@@ -74,6 +79,7 @@
 
     <sect2 id="zend.validate.set.date">
         <title>Date</title>
+
         <para>
             <code>$value</code> が 'YYYY-MM-DD' 形式の日付である場合にのみ
             <constant>TRUE</constant> を返します。オプションの <property>locale</property>
@@ -89,6 +95,7 @@
 
     <sect2 id="zend.validate.set.digits">
         <title>Digits</title>
+
         <para>
             <code>$value</code> が数字のみで構成されている場合にのみ <constant>TRUE</constant> を返します。
         </para>
@@ -98,6 +105,7 @@
 
     <sect2 id="zend.validate.set.float">
         <title>Float</title>
+
         <para>
             <code>$value</code> が浮動小数点値である場合にのみ <constant>TRUE</constant> を返します。
             Zend Framework 1.8 以降では、このバリデータは
@@ -109,31 +117,31 @@
 
     <sect2 id="zend.validate.set.greater_than">
         <title>GreaterThan</title>
-        <para>
-            <code>$value</code> が最小値よりも大きい場合にのみ <constant>TRUE</constant> を返します。
-        </para>
-    </sect2>
 
-    <sect2 id="zend.validate.set.hex">
-        <title>Hex</title>
         <para>
-            <code>$value</code> が16進文字のみで構成されている場合にのみ <constant>TRUE</constant> を返します。
+            <code>$value</code> が最小値よりも大きい場合にのみ <constant>TRUE</constant> を返します。
         </para>
     </sect2>
 
+    <xi:include href="Zend_Validate-Hex.xml">
+        <xi:fallback><xi:include href="../../en/module_specs/Zend_Validate-Hex.xml" /></xi:fallback>
+    </xi:include>
     <xi:include href="Zend_Validate-Hostname.xml" />
 
     <sect2 id="zend.validate.set.iban">
         <title>Iban</title>
+
         <para>
             <code>$value</code> が正しい IBAN
             (International Bank Account Number) を含む場合にのみ <constant>TRUE</constant> を返します。
             IBAN 番号の検証は、使用している国に対して行い、チェックサムを使用します。
         </para>
+
         <para>
             IBAN 番号の検証方法は 2 通りあります。最初の方法では、国を表すロケールを指定します。
             その国に対して、指定した IBAN 番号の検証を行います。
         </para>
+
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Iban('de_AT');
 $iban = 'AT611904300234573201';
@@ -146,10 +154,12 @@ if ($validator->isValid($iban)) {
     }
 }
 ]]></programlisting>
+
         <para>
             これは、IBAN 番号をひとつの国に対して検証したい場合に使用します。
             もっとシンプルな方法としては、この例のようにロケールを指定しないものもあります。
         </para>
+
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Iban();
 $iban = 'AT611904300234573201';
@@ -159,6 +169,7 @@ if ($validator->isValid($iban)) {
     // IBAN は無効です
 }
 ]]></programlisting>
+
         <para>
             しかしこれには大きな問題がひとつあります。
             たとえばフランスならフランスなど 1 か国だけの IBAN 番号を許可したいときに、
@@ -176,6 +187,7 @@ if ($validator->isValid($iban)) {
 
     <sect2 id="zend.validate.set.int">
         <title>Int</title>
+
         <para>
             <code>$value</code> が整数値である場合にのみ <constant>TRUE</constant> を返します。
             Zend Framework 1.8 以降では、このバリデータは
@@ -194,6 +206,7 @@ if ($validator->isValid($iban)) {
 
     <sect2 id="zend.validate.set.less_than">
         <title>LessThan</title>
+
         <para>
             <code>$value</code> が最大値よりも小さい場合にのみ <constant>TRUE</constant> を返します。
         </para>
@@ -209,6 +222,7 @@ if ($validator->isValid($iban)) {
 
     <sect2 id="zend.validate.set.regex">
         <title>Regex</title>
+
         <para>
             <code>$value</code> が正規表現パターンにマッチする場合にのみ <constant>TRUE</constant> を返します。
         </para>
@@ -218,6 +232,7 @@ if ($validator->isValid($iban)) {
 
     <sect2 id="zend.validate.set.string_length">
         <title>StringLength</title>
+
         <para>
             文字列 <code>$value</code> の長さが最小値以上、
             かつ最大値以下 (最大値が <constant>NULL</constant> 以外のとき)