[DOCUMENTATION]Japanese new Zend_Validate_Ip, and update 16 files.

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

documentation/manual/ja/module_specs/Zend_Config_Writer.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18867 -->
+<!-- EN-Revision: 19161 -->
 <sect1 id="zend.config.writer.introduction">
     <title>Zend_Config_Writer</title>
+
     <para>
         <classname>Zend_Config_Writer</classname> は、設定ファイルに
         <classname>Zend_Config</classname> オブジェクトを書き出します。
@@ -39,8 +40,8 @@
      <para>
         Ini ライターでは、セクションについてのレンダリング用のモードが２つあります。
         既定では、トップレベルの構成節は、常にセクション名に含まれます。
-        <code>$writer->setRenderWithoutSections()</code> を呼ぶことにより、
-        オプションの全てが INI ファイルのグローバル名前空間に含まれます。
+        <command>$writer->setRenderWithoutSections()</command> を呼ぶことにより、
+        オプションの全てが <acronym>INI</acronym> ファイルのグローバル名前空間に含まれます。
         そして、セクションは使用されません。
     </para>
 
@@ -140,9 +141,9 @@ $writer->write();
     </note>
 
     <para>
-        構成節の文字列を作成するために、
-        ファイル・ベースのライタ（INI、XMLとPHP配列）全てで内部的に
-        <methodname>render()</methodname> が使用されます。
+        構成節の文字列を作成するために、ファイル・ベースのライタ
+        （ <acronym>INI</acronym> 、 <acronym>XML</acronym> 及び <acronym>PHP</acronym> 配列）
+        全てで内部的に <methodname>render()</methodname> が使用されます。
         コンフィギュレーション・データの文字列表現にアクセスする必要があれば、
         このメソッドを外部からも使用できます。
     </para>

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

@@ -1,15 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 16603 -->
+<!-- EN-Revision: 19161 -->
 <sect3 id="zend.controller.plugins.standard.puthandler">
     <title>Zend_Controller_Plugin_PutHandler</title>
 
     <para>
         <classname>Zend_Controller_Plugin_PutHandler</classname>は、
-        まるでPOSTリクエスト・ボディのようなリクエスト・パラメータにPUTリクエスト・ボディを配置するために、
+        まるで <acronym>POST</acronym> リクエスト・ボディのようなリクエスト・パラメータに
+        <acronym>PUT</acronym> リクエスト・ボディを配置するために、
         ドロップイン・プラグインを提供します。
-        それはリクエストを調べます、そして、PUTならば、
-        生のPUTボディを解析してリクエストに配置されるパラメータの配列にするためにparse_strを使います。
+        それはリクエストを調べます、そして、 <acronym>PUT</acronym> ならば、
+        生の <acronym>PUT</acronym> ボディを解析してリクエストに配置されるパラメータの配列にするためにparse_strを使います。
         例えば、
     </para>
 
@@ -30,7 +31,7 @@ $front->registerPlugin(new Zend_Controller_Plugin_PutHandler());
 ]]></programlisting>
 
     <para>
-        そして、コントローラ内でリクエストからPUTボディー・パラメータに名前によるアクセスができます:
+        そして、コントローラ内でリクエストから <acronym>PUT</acronym> ボディー・パラメータに名前によるアクセスができます:
     </para>
 
     <programlisting language="php"><![CDATA[

documentation/manual/ja/module_specs/Zend_Controller-Router-Route-Rest.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17991 -->
+<!-- EN-Revision: 19161 -->
 <sect3 id="zend.controller.router.routes.rest">
     <title>Zend_Rest_Route</title>
 
@@ -29,39 +29,39 @@
             </thead>
             <tbody>
                 <row>
-                    <entry>GET</entry>
+                    <entry><acronym>GET</acronym></entry>
                     <entry><filename>/product/ratings/</filename></entry>
                     <entry><methodname>Product_RatingsController::indexAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>GET</entry>
+                    <entry><acronym>GET</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry><methodname>Product_RatingsController::getAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><filename>/product/ratings</filename></entry>
                     <entry><methodname>Product_RatingsController::postAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>PUT</entry>
+                    <entry><acronym>PUT</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry><methodname>Product_RatingsController::putAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>DELETE</entry>
+                    <entry><acronym>DELETE</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry>
                         <methodname>Product_RatingsController::deleteAction()</methodname>
                     </entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><command>/product/ratings/:id?_method="PUT"</command></entry>
                     <entry><methodname>Product_RatingsController::putAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><command>/product/ratings/:id?_method="DELETE"</command></entry>
                     <entry>
                         <methodname>Product_RatingsController::deleteAction()</methodname>

documentation/manual/ja/module_specs/Zend_Currency-Usage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17597 -->
+<!-- EN-Revision: 19150 -->
 <sect1 id="zend.currency.usage">
 
     <title>通貨の操作方法</title>

documentation/manual/ja/module_specs/Zend_Date-Constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18842 -->
+<!-- EN-Revision: 19162 -->
 <sect1 id="zend.date.constants">
 
     <title>日付関数全般用の定数</title>

documentation/manual/ja/module_specs/Zend_Date-Overview.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18842 -->
+<!-- EN-Revision: 19162 -->
 <sect1 id="zend.date.overview">
 
     <title>Zend_Date API の概要</title>

documentation/manual/ja/module_specs/Zend_Db_Select.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18196 -->
+<!-- EN-Revision: 19162 -->
 <sect1 id="zend.db.select">
 
     <title>Zend_Db_Select</title>
@@ -822,6 +822,31 @@ $select = $db->select()
 
             </example>
 
+             <para>
+                SQL の IN 演算子を使うとき、 <methodname>where()</methodname> メソッドに
+                第２引数として配列を渡せます。
+            </para>
+
+            <example id="zend.db.select.building.where.example-array">
+
+                <title>where() メソッドでの配列パラメータ例</title>
+
+                <programlisting language="php"><![CDATA[
+// クエリをビルド
+//   SELECT product_id, product_name, price
+//   FROM "products"
+//   WHERE (product_id IN (1, 2, 3))
+
+$productIds = array(1, 2, 3);
+
+$select = $db->select()
+             ->from('products',
+                    array('product_id', 'product_name', 'price'))
+             ->where('product_id IN (?)', $productIds);
+]]></programlisting>
+
+            </example>
+
             <para>
                 <classname>Zend_Db_Select</classname> オブジェクト上で、<methodname>where()</methodname>
                 メソッドを複数回実行することもできます。その結果のクエリは、

documentation/manual/ja/module_specs/Zend_Db_Table.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18737 -->
+<!-- EN-Revision: 19139 -->
 <sect1 id="zend.db.table">
 
     <title>Zend_Db_Table</title>
@@ -891,7 +891,9 @@ $rows = $table->find(array(1234, 5678), array('ABC', 'DEF'));
                     <para>
 
                         <programlisting language="php"><![CDATA[
-// 行セットを取得します
+/**
+ * 行セットを取得します
+ */
 $rows = $table->fetchAll(
     'bug_status = "NEW"',
     'bug_id ASC',
@@ -904,8 +906,18 @@ $rows = $table->fetchAll(
         ->order('bug_id ASC')
         ->limit(10, 0)
     );
+// またはバインディングを用いて
+$rows = $table->fetchAll(
+    $table->select()
+        ->where('bug_status = :status')
+        ->bind(array(':status'=>'NEW')
+        ->order('bug_id ASC')
+        ->limit(10, 0)
+    );
 
-// 単一の行を取得します
+/**
+ * 単一の行を取得します
+ */
 $row = $table->fetchRow(
     'bug_status = "NEW"',
     'bug_id ASC'
@@ -915,6 +927,13 @@ $row = $table->fetchRow(
         ->where('bug_status = ?', 'NEW')
         ->order('bug_id ASC')
     );
+// またはバインディングを用いて
+$row = $table->fetchRow(
+    $table->select()
+        ->where('bug_status = :status')
+        ->bind(array(':status'=>'NEW')
+        ->order('bug_id ASC')
+    );
 ]]></programlisting>
 
                     </para>

documentation/manual/ja/module_specs/Zend_Dojo-Form-Elements.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17598 -->
+<!-- EN-Revision: 19143 -->
 <sect2 id="zend.dojo.form.elements">
     <title>Dijit固有のフォーム要素</title>
 
@@ -223,7 +223,7 @@ $form->addElement(
             選ばれた選択肢を調べて、セットするためにアクセッサとミューテーターを提供します。
             それらはDijitMultiから拡張します。
             そして、それは<methodname>setMultiOptions()</methodname>及び<methodname>setMultiOption()</methodname>メソッドによって
-            選ばれた選択肢を指定することができます。
+            選ばれた選択肢を指定できます。
             さらに、以下のメソッドを利用できます:
         </para>
 
@@ -287,7 +287,7 @@ $form->addElement(
             この要素はデフォルトで登録します。
             <methodname>setRegisterInArrayValidator(false)</methodname>を呼び出すことでも、
             <code>registerInArrayValidator</code>設定キーにfalse値を渡すことでも、
-            このふるまいを抑制することができます。
+            このふるまいを抑制できます。
         </para>
 
         <example id="zend.dojo.form.elements.comboBox.selectExample">
@@ -651,6 +651,39 @@ $form->addElement('editor', 'content', array(
 ));
 ]]></programlisting>
         </example>
+
+        <note>
+            <title>エディタ Dijit は既定で div を使います</title>
+
+            <para>
+                エディタ dijit は既定で <acronym>HTML</acronym> の <acronym>DIV</acronym> を使います。
+                <classname>dijit._editor.RichText</classname> 資料は、
+                HTML の <acronym>TEXTAREA</acronym> の上にビルドされたそれを持つことが
+                セキュリティに影響するかもしれないことを示します。
+            </para>
+
+            <para>
+                言うことには、<acronym>TEXTAREA</acronym>に上品に退化できる
+                エディタ・ウィジェットを望む機会があるかもしれません。
+                そのような場面では、 <varname>degrade</varname> プロパティを <constant>true</constant>
+                に設定することによってそうすることができます。
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// 初期化にて
+$editor = new Zend_Dojo_Form_Element_Editor('foo', array(
+    'degrade' => true,
+));
+
+// フォームを通じた構築
+$form->addElement('editor', 'content', array(
+    'degrade' => true,
+));
+
+// または初期化後
+$editor->degrade = true;
+]]></programlisting>
+        </note>
     </sect3>
 
     <sect3 id="zend.dojo.form.elements.horizontalSlider">
@@ -881,7 +914,7 @@ $form->addElement(
             数テキストボックスは、数を入力するためのテキスト要素です;
             数スピナーとは異なり、数は手で入力します。
             バリデーションと制約は、
-            数が特定の範囲または形式にとどまることを確実とするために提示することができます。
+            数が特定の範囲または形式にとどまることを確実とするために提示できます。
         </para>
 
         <para>
@@ -996,7 +1029,7 @@ $form->addElement(
         <para>
             ラジオボタンはDijitMultiから拡張します。
             そして、<methodname>setMultiOptions()</methodname>及び<methodname>setMultiOption()</methodname>メソッドによって
-            選ばれた選択肢を指定することができます。
+            選ばれた選択肢を指定できます。
         </para>
 
         <para>
@@ -1004,7 +1037,7 @@ $form->addElement(
             配列に対して登録された選択肢のキーを確認する<code>InArray</code>バリデーターを登録します。
             <methodname>setRegisterInArrayValidator(false)</methodname>または
             <code>registerInArrayValidator</code>のどちらを呼び出しても、
-            設定キーにfalse値を渡すことによってこのふるまいを抑制することができます。
+            設定キーにfalse値を渡すことによってこのふるまいを抑制できます。
         </para>
 
         <example id="zend.dojo.form.elements.radioButton.example">

documentation/manual/ja/module_specs/Zend_File_Transfer-Introduction.xml

@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17618 -->
+<!-- EN-Revision: 19150 -->
 <sect1 id="zend.file.transfer.introduction">
 
     <title>Zend_File_Transfer</title>
 
     <para>
         <classname>Zend_File_Transfer</classname> を使用すると、
-        ファイルのアップロードやダウンロードを管理することができます。
+        ファイルのアップロードやダウンロードを管理できます。
         組み込みのバリデータを使ってファイルを検証したり、
         フィルタによってファイルを変更したりという機能があります。
         <classname>Zend_File_Transfer</classname> はアダプタ形式を採用しており、
-        <acronym>HTTP</acronym> や FTP、WEBDAV などのさまざまな転送プロトコルを同じ <acronym>API</acronym> で使用することができます。
+        <acronym>HTTP</acronym> や FTP、WEBDAV などのさまざまな転送プロトコルを同じ <acronym>API</acronym> で使用できます。
     </para>
 
     <note>
@@ -89,7 +89,7 @@ if (!$adapter->receive()) {
             ローカルの保存先を <code>setDestination</code> メソッドで指定して
             <methodname>receive()</methodname> メソッドをコールします。
             アップロード時に何らかのエラーが発生した場合は、
-            返された例外の中でその情報を取得することができます。
+            返された例外の中でその情報を取得できます。
         </para>
 
     </example>
@@ -410,7 +410,7 @@ $names = $upload->getMimeType('foo');
 
         <para>
             これらふたつの条件さえ満たせば、ファイルアップロードの進捗状況を
-            <code>getProgress</code> メソッドで取得することができます。
+            <code>getProgress</code> メソッドで取得できます。
             実際には、これを処理する公式な方法は 2 通りあります。
         </para>
 

documentation/manual/ja/module_specs/Zend_Filter-Decryption.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17154 -->
+<!-- EN-Revision: 19150 -->
 <sect2 id="zend.filter.set.decrypt">
     <title>Decrypt</title>
     <para>

documentation/manual/ja/module_specs/Zend_Filter-Encryption.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17154 -->
+<!-- EN-Revision: 19150 -->
 <sect2 id="zend.filter.set.encrypt">
     <title>Encrypt</title>
     <para>
@@ -27,7 +27,7 @@ $filter2 = new Zend_Filter_Encrypt(array('adapter' => 'openssl'));
     <para>
         別のアダプタを設定するために <methodname>setAdapter()</methodname>
         を使用することもできます。また <methodname>getAdapter()</methodname>
-        メソッドで、実際に設定されているアダプタを取得することができます。
+        メソッドで、実際に設定されているアダプタを取得できます。
     </para>
 
     <programlisting language="php"><![CDATA[
@@ -198,7 +198,7 @@ print $encrypted;
             後から公開鍵を取得あるいは設定するには、<methodname>getPublicKey()</methodname>
             および <methodname>setPublicKey()</methodname> メソッドを使用します。
             秘密鍵についても、<methodname>getPrivateKey()</methodname> および <methodname>setPrivateKey()</methodname>
-            メソッドで取得あるいは設定することができます。
+            メソッドで取得あるいは設定できます。
         </para>
 
         <programlisting language="php"><![CDATA[

documentation/manual/ja/module_specs/Zend_Filter.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17848 -->
+<!-- EN-Revision: 19150 -->
 <sect1 id="zend.filter.introduction">
 
     <title>導入</title>
@@ -8,7 +8,7 @@
     <para>
         <classname>Zend_Filter</classname> コンポーネントは、データのフィルタリングに必要となる一般的な機能を提供します。
         シンプルなフィルタチェイン機能も持っており、
-        ひとつのデータに対して複数のフィルタを指定した順に適用することができます。
+        ひとつのデータに対して複数のフィルタを指定した順に適用できます。
     </para>
 
     <sect2 id="zend.filter.introduction.definition">
@@ -121,7 +121,7 @@ echo Zend_Filter::filterStatic('"', 'HtmlEntities', array('quotestyle' => ENT_QU
             <para>
                 自分で定義したフィルタを使う際に、
                 <methodname>Zend_Filter::filterStatic()</methodname> に
-                4 番目のパラメータを指定することができます。
+                4 番目のパラメータを指定できます。
                 これは、フィルタを探すための名前空間となります。
             </para>
 
@@ -164,7 +164,7 @@ echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
                     <para>
                         <emphasis><methodname>Zend_Filter::setDefaultNamespaces()</methodname></emphasis>:
                         新たなデフォルト名前空間を設定し、既存の名前空間を上書きします。
-                        単一の名前空間の場合は文字列、複数の場合は配列で指定することができます。
+                        単一の名前空間の場合は文字列、複数の場合は配列で指定できます。
                     </para>
                 </listitem>
 
@@ -172,7 +172,7 @@ echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
                     <para>
                         <emphasis><methodname>Zend_Filter::addDefaultNamespaces()</methodname></emphasis>:
                         新たな名前空間を、既に設定されているものに追加します。
-                        単一の名前空間の場合は文字列、複数の場合は配列で指定することができます。
+                        単一の名前空間の場合は文字列、複数の場合は配列で指定できます。
                     </para>
                 </listitem>
 

documentation/manual/ja/module_specs/Zend_Locale-Functions.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 19150 -->
 <sect1 id="zend.locale.functions">
 
     <title>Zend_Locale の使用法</title>
@@ -17,7 +17,7 @@
 
         <para>
             <ulink url="http://php.net/language.oop5.cloning">オブジェクトのクローンを作成</ulink>し、
-            ロケールオブジェクトを正確かつ効率的に複製することができます。
+            ロケールオブジェクトを正確かつ効率的に複製できます。
             ロケール対応のメソッドのほとんどは、<code>$locale->toString()</code>
             が返す文字列表現のロケールを受け付けます。
         </para>
@@ -192,7 +192,7 @@ print $locale->getRegion();
         <title>地域化された文字列の取得</title>
 
         <para>
-            <methodname>getTranslationList()</methodname> を使用すると、地域化された情報を利用することができます。
+            <methodname>getTranslationList()</methodname> を使用すると、地域化された情報を利用できます。
             これらの情報は、各地域に特化したデータを顧客に対して提供する際に
             翻訳の必要がなくなるので便利です。
             これらはすでに使用可能となっています。
@@ -312,7 +312,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                           このロケールにおけるすべての月の表現の一覧を返します。
                           異なる表現方式がある場合は配列として返されます。
                           値を省略すると、グレゴリオ暦におけるすべての月の一覧を返します。
-                          値として、既知の暦の名前を指定することができます。
+                          値として、既知の暦の名前を指定できます。
                           その場合は指定した暦における月の一覧を返します。
                           単純に行うには
                           <link linkend="zend.date.introduction">Zend_Date</link>
@@ -339,7 +339,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                           このロケールにおけるすべての曜日の表現の一覧を返します。
                           異なる表現方式がある場合は配列として返されます。
                           値を省略すると、グレゴリオ暦におけるすべての曜日の一覧を返します。
-                          値として、既知の暦の名前を指定することができます。
+                          値として、既知の暦の名前を指定できます。
                           その場合は指定した暦における曜日の一覧を返します。
                           単純に行うには
                           <link linkend="zend.date.introduction">Zend_Date</link>
@@ -375,7 +375,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                           このロケールにおけるすべての四半期の表現の一覧を返します。
                           異なる表現方式がある場合は配列として返されます。
                           値を省略すると、グレゴリオ暦におけるすべての四半期の一覧を返します。
-                          値として、既知の暦の名前を指定することができます。
+                          値として、既知の暦の名前を指定できます。
                           その場合は指定した暦における四半期の一覧を返します。
                         </entry>
                     </row>
@@ -395,7 +395,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry>
                           このロケールにおけるすべての紀元の表現の一覧を返します。
                           値を省略すると、グレゴリオ暦におけるすべての紀元の一覧を返します。
-                          値として、既知の暦の名前を指定することができます。
+                          値として、既知の暦の名前を指定できます。
                           その場合は指定した暦における紀元の一覧を返します。
                         </entry>
                     </row>
@@ -771,7 +771,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
         <para>
             単一の翻訳データがほしい場合は、<methodname>getTranslation()</methodname> を使用します。
             この関数は常に文字列を返しますが、<methodname>getTranslationList()</methodname>
-            メソッドよりも多くの型を使用することができます。
+            メソッドよりも多くの型を使用できます。
             また、値についても一点を除いて同じです。
             取得したい値について、詳細を指定する必要があります。
         </para>

documentation/manual/ja/module_specs/Zend_Rest.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 19162 -->
 <sect1 id="zend.rest.introduction">
     <title>導入</title>
 
@@ -16,9 +16,17 @@
         両方組み合わせて使用すると、ローカル環境上で仮想的なオブジェクト間のやり取りを体験できます。
         サーバコンポーネントは、関数やクラスを意味のある単純な <acronym>XML</acronym>
         形式で自動的に公開します。このサービスに対してクライアントからアクセスすると、
-        リモートコールの返すデータを簡単に取得することができます。
+        リモートコールの返すデータを簡単に取得できます。
         クライアント側で Zend_Rest_Server ベースのサービス以外と組み合わせて使用する際にも、
-        簡単にデータにアクセスすることができます。
+        簡単にデータにアクセスできます。
+    </para>
+
+    <para>
+        
+        <classname>Zend_Rest_Server</classname> 及び <classname>Zend_Rest_Client</classname>
+        コンポーネントに加えて、コントローラに REST リクエストをルーティングすることを助けるために
+        <link linkend="zend.controller.router.routes.rest"><classname>Zend_Rest_Route</classname>
+        及び <classname>Zend_Rest_Controller</classname></link> クラスが、提供されます。
     </para>
 </sect1>
 

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

@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 19150 -->
+<sect2 id="zend.validate.set.ip">
+
+    <title>Ip</title>
+
+    <para>
+        <classname>Zend_Validate_Ip</classname> は、与えられた値が
+        IP アドレスかどうか検証できるようにします。
+        これは IPv4 及び IPv6 標準をサポートします。
+    </para>
+
+    <sect3 id="zend.validate.set.ip.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+            基本的な使用法は、以下のようになります。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Ip();
+if ($validator->isValid($ip)) {
+    // ip は正しい形式のようです
+} else {
+    // ip が不正なので、理由を表示します
+}
+]]></programlisting>
+
+        <note>
+            <title>IP アドレスの検証</title>
+
+            <para>
+                <classname>Zend_Validate_Ip</classname> は IP アドレスだけを検証することを記憶にとどめてください。
+                'mydomain.com' や '192.168.50.1/index.html' のようなアドレスは、有効な IP アドレスではありません。
+                それらは IP アドレスではなく、 hostname または 有効な <acronym>URL</acronym> です。
+            </para>
+        </note>
+
+        <note>
+            <title>IPv6 の検証</title>
+
+            <para>
+                <classname>Zend_Validate_Ip</classname> は正規表現で IPv6 アドレスを検証します。
+                それは、 PHP 自身のフィルターやメソッドが RFC に準拠していないからです。
+                他の多くの利用可能なクラスもまた、それに準拠しません。
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.validate.set.ip.singletype">
+        <title>IPv4 または IPV6 だけを検証</title>
+
+        <para>
+            しばしば、サポートされる形式のうちの１つだけを検証するために役立ちます。
+            たとえば、ネットワークが IPv4 だけをサポートするときです。
+            この場合、このバリデータ内で IPv6 を受け付けることは無駄でしょう。
+        </para>
+
+        <para>
+            <classname>Zend_Validate_Ip</classname> をプロトコル１つに制限するために、
+            オプション <property>allowipv4</property> または <property>allowipv6</property> を
+            <constant>FALSE</constant> に設定できます。
+            これは、コンストラクタにオプションを与えることによって、
+            または、その後 <methodname>setOptions()</methodname> を用いて行なえます。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_Ip(array('allowipv6' => false);
+if ($validator->isValid($ip)) {
+    // ip は正しい ip4v アドレスのようです
+} else {
+    // ip は ipv4 アドレスではありません
+}
+]]></programlisting>
+
+        <note>
+            <title>既定の動作</title>
+
+            <para>
+                <classname>Zend_Validate_Ip</classname> が従う既定の動作は
+                両方の標準を受け付ける、です。
+            </para>
+        </note>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/ja/module_specs/Zend_Validate.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18028 -->
+<!-- EN-Revision: 19150 -->
 <sect1 id="zend.validate.introduction">
 
     <title>導入</title>
@@ -8,7 +8,7 @@
     <para>
         <classname>Zend_Validate</classname> コンポーネントは、一般的に必要となるバリデータを提供します。
         シンプルなバリデータチェイン機能も持っており、
-        ひとつのデータに対して複数のバリデータを指定した順に適用することができます。
+        ひとつのデータに対して複数のバリデータを指定した順に適用できます。
     </para>
 
     <sect2 id="zend.validate.introduction.definition">
@@ -97,7 +97,7 @@ if ($validator->isValid($email)) {
         <para>
             バリデータクラスの <methodname>setMessage()</methodname> メソッドを使用すると、
             検証に失敗した場合に <methodname>getMessages()</methodname>
-            が返すメッセージの書式を設定することができます。
+            が返すメッセージの書式を設定できます。
             最初の引数にはエラーメッセージを文字列で指定します。
             このメッセージに特定のトークンを含めると、
             バリデータがそれを実際の値に置き換えます。
@@ -153,7 +153,7 @@ $validator->setMessages( array(
 
         <para>
             より柔軟な検証失敗報告をしたい場合のために、
-            バリデーションクラスがサポートするメッセージトークンと同じ名前のプロパティを使用することができます。
+            バリデーションクラスがサポートするメッセージトークンと同じ名前のプロパティを使用できます。
             どのバリデータでも常に使用可能なプロパティは <code>value</code> です。
             これは、<methodname>isValid()</methodname> の引数として渡した値を返します。
             その他のプロパティについては、バリデーションクラスによって異なります。
@@ -238,7 +238,7 @@ if (Zend_Validate::is($value, 'Between', array('min' => 1, 'max' => 12))) {
 
             <para>
                 自分で定義したバリデータを使う際に、
-                <methodname>Zend_Validate::is()</methodname> に 4 番目のパラメータを指定することができます。
+                <methodname>Zend_Validate::is()</methodname> に 4 番目のパラメータを指定できます。
                 これは、バリデータを探すための名前空間となります。
             </para>
 
@@ -283,7 +283,7 @@ iif (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                     <para>
                         <emphasis><methodname>Zend_Validate::setDefaultNamespaces()</methodname></emphasis>:
                         新たなデフォルト名前空間を設定し、既存の名前空間を上書きします。
-                        単一の名前空間の場合は文字列、複数の場合は配列で指定することができます。
+                        単一の名前空間の場合は文字列、複数の場合は配列で指定できます。
                     </para>
                 </listitem>
 
@@ -291,7 +291,7 @@ iif (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                     <para>
                         <emphasis><methodname>Zend_Validate::addDefaultNamespaces()</methodname></emphasis>:
                         新たな名前空間を、既に設定されているものに追加します。
-                        単一の名前空間の場合は文字列、複数の場合は配列で指定することができます。
+                        単一の名前空間の場合は文字列、複数の場合は配列で指定できます。
                     </para>
                 </listitem>
 
@@ -312,7 +312,7 @@ iif (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
 
         <para>
             Validate クラスには <methodname>setTranslator()</methodname> メソッドがあり、
-            <classname>Zend_Translate</classname> のインスタンスを指定することができます。
+            <classname>Zend_Translate</classname> のインスタンスを指定できます。
             これが、検証に失敗したときのメッセージを翻訳します。
             <methodname>getTranslator()</methodname> メソッドは、設定されているインスタンスを返します。
         </para>
@@ -331,7 +331,7 @@ $validator->setTranslator($translate);
         <para>
             静的メソッド <methodname>setDefaultTranslator()</methodname> で
             <classname>Zend_Translate</classname> のインスタンスを設定すると、
-            それをすべての検証クラスで使用することができます。この設定内容を取得するのが
+            それをすべての検証クラスで使用できます。この設定内容を取得するのが
             <methodname>getDefaultTranslator()</methodname> です。これを使用すると、
             個々のバリデータクラスで手動で翻訳器を設定せずに済むのでコードがシンプルになります。
         </para>
@@ -356,7 +356,7 @@ Zend_Validate::setDefaultTranslator($translate);
             時には、検証時に翻訳器を無効にしなければならないこともあるでしょう。
             そんな場合は <methodname>setDisableTranslator()</methodname> メソッドを使用します。
             このメソッドには boolean パラメータを指定します。また <methodname>translatorIsDisabled()</methodname>
-            で現在の値を取得することができます。
+            で現在の値を取得できます。
         </para>
 
         <programlisting language="php"><![CDATA[