[DOCUMENT] Japanese sync

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20765 -->
+<!-- EN-Revision: 21684 -->
 <sect1 id="zend.controller.exceptions">
     <title>MVC での例外</title>
 
@@ -13,7 +13,7 @@
             つまり、あるサイトに対するすべてのリクエストを
             ひとつのエントリポイントで処理するということです。その結果、
             すべての例外は最終的にフロントコントローラに到達することになります。
-            開発者は、例外をここでまとめて処理することができます。
+            開発者は、例外をここでまとめて処理できます。
         </para>
 
         <para>
@@ -85,7 +85,7 @@ try {
                 <para>
                     これが、自分のアプリケーションで独自の例外処理を行うための
                     もっとも簡単な方法でしょう。
-                    この方法で、発生しうるすべての例外を処理することができます。
+                    この方法で、発生しうるすべての例外を処理できます。
                 </para>
             </listitem>
 
@@ -311,7 +311,7 @@ class My_Controller_Dispatcher extends Zend_Controller_Dispatcher
                             アプリケーション内でさまざまなアクションコントローラを使用しているとしましょう。
                             それらがすべて同一のクラスを継承しているとは限りません。
                             そのような場合にこの方式を使用すると、
-                            さまざまなクラスに対して一貫した処理を行うことができます。
+                            さまざまなクラスに対して一貫した処理を行えます。
                         </para>
 
                         <para>
@@ -326,7 +326,7 @@ class My_Controller_PreDispatchPlugin extends Zend_Controller_Plugin_Abstract
         $front      = Zend_Controller_Front::getInstance();
         $dispatcher = $front->getDispatcher();
         $class      = $dispatcher->getControllerClass($request);
-        if (!$controller) {
+        if (!$class) {
             $class = $dispatcher->getDefaultControllerClass($request);
         }
 

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17592 -->
+<!-- EN-Revision: 21661 -->
 <sect3 id="zend.controller.router.routes.standard">
     <title>Zend_Controller_Router_Route</title>
 
@@ -42,6 +42,7 @@ $router->addRoute('user', $route);
 
     <note>
         <title>文字の使用法</title>
+
         <para>
             現在の実装では、(スラッシュ以外の)
             任意の文字を変数名として使用できます。しかし、
@@ -105,7 +106,7 @@ $router->addRoute('default', $route);
         <title>変数のデフォルト</title>
 
         <para>
-            ルートで使用するすべての変数についてデフォルト値を指定することができます。
+            ルートで使用するすべての変数についてデフォルト値を指定できます。
             これは、 <classname>Zend_Controller_Router_Route</classname>
             のコンストラクタの 2 番目のパラメータで指定します。
             このパラメータは、変数名をキーとする配列で、
@@ -161,7 +162,7 @@ $router->addRoute('archive', $route);
 
         <para>
             <classname>Zend_Controller_Router_Route</classname> のコンストラクタの
-            三番目のパラメータで、変数の制約を指定することができます。
+            三番目のパラメータで、変数の制約を指定できます。
             これは、正規表現で指定します。
         </para>
 
@@ -202,12 +203,14 @@ $router->addRoute('archive', $route);
                     レジストリに、キー <classname>Zend_Translate</classname> で格納する
                 </para>
             </listitem>
+
             <listitem>
                 <para>
                     静的メソッド
                     <methodname>Zend_Controller_Router_Route::setDefaultTranslator()</methodname> で設定する
                 </para>
             </listitem>
+
             <listitem>
                 <para>
                     コンストラクタの 4 番目のパラメータとして渡す
@@ -228,17 +231,20 @@ $router->addRoute('archive', $route);
                     レジストリに、キー <classname>Zend_Locale</classname> で格納する
                 </para>
             </listitem>
+
             <listitem>
                 <para>
                     静的メソッド
                     <methodname>Zend_Controller_Router_Route::setDefaultLocale()</methodname> で設定する
                 </para>
             </listitem>
+
             <listitem>
                 <para>
                     コンストラクタの 5 番目のパラメータとして渡す
                 </para>
             </listitem>
+
             <listitem>
                 <para>
                     アセンブルメソッドのパラメータ <command>@locale</command> として渡す
@@ -260,6 +266,7 @@ $router->addRoute('archive', $route);
 
         <note>
             <title>メッセージ ID と分割された言語ファイル</title>
+
             <para>
                 ルートの中で使いたいメッセージ ID が、
                 ビュースクリプトやその他の部分ですでに使われていることもあるでしょう。
@@ -275,12 +282,25 @@ $router->addRoute('archive', $route);
 
         <programlisting language="php"><![CDATA[
 // 翻訳器を準備します
-$translator = new Zend_Translate('array', array(), 'en');
-$translator->addTranslation(array('archive' => 'archiv',
-                                  'year'    => 'jahr',
-                                  'month'   => 'monat',
-                                  'index'   => 'uebersicht'),
-                            'de');
+$translator = new Zend_Translate(
+    array(
+        'adapter' => 'array',
+        'content' => array(),
+        'locale'  => 'en'
+    )
+);
+$translator->addTranslation(
+    array(
+        'content' =>
+            array(
+                'archive' => 'archiv',
+                'year'    => 'jahr',
+                'month'   => 'monat',
+                'index'   => 'uebersicht'
+            ),
+        'locale'  => 'de'
+    )
+);
 
 // 現在のロケールを翻訳器に設定します
 $translator->setLocale('en');

documentation/manual/ja/module_specs/Zend_Dom.xml

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 21358 -->
 <sect1 id="zend.dom.introduction">
     <title>導入</title>
 
     <para>
-        <classname>Zend_Dom</classname> は、DOM ドキュメントや構造を扱うためのツールを提供します。
+        <classname>Zend_Dom</classname> は、 <acronym>DOM</acronym> ドキュメントや構造を扱うためのツールを提供します。
         現在用意しているのは <classname>Zend_Dom_Query</classname> で、これは XPath や <acronym>CSS</acronym> セレクタによる
-        DOM ドキュメントの問い合わせを共通インターフェイスで行えるようにします。
+        <acronym>DOM</acronym> ドキュメントの問い合わせを共通インターフェイスで行えるようにします。
     </para>
 </sect1>
 <!--

documentation/manual/ja/module_specs/Zend_Feed-ModifyingFeed.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21586 -->
 <sect1 id="zend.feed.modifying-feed">
     <title>フィードおよびエントリの構造の変更</title>
 
@@ -25,21 +25,21 @@ echo $entry->saveXML();
 ]]></programlisting>
         <para>
             これは、必要な <acronym>XML</acronym> 名前空間も含めた完全な
-            (最初の <code>&lt;?xml ... &gt;</code> も含めた)
+            (最初の <command>&lt;?xml ... &gt;</command> も含めた)
             <acronym>XML</acronym> 表記で新しいエントリを出力します。
         </para>
 
         <para>
             既存のエントリが author タグを保持していない場合にも、
             上の例は正しく動作することに注意しましょう。
-            代入する場所を指定するために、いくらでも <code>-&gt;</code>
+            代入する場所を指定するために、いくらでも <command>-&gt;</command>
             をつなげることができます。その途中の段階の要素は、
             必要に応じて自動的に作成されます。
         </para>
     </example>
 
     <para>
-        <code>atom:</code>、<code>rss:</code>、<code>osrss:</code>
+        <command>atom:</command>、<command>rss:</command>、<command>osrss:</command>
         以外の名前空間をエントリで使用したい場合は、<methodname>Zend_Feed::registerNamespace()</methodname>
         を使用して <classname>Zend_Feed</classname> で名前空間を登録する必要があります。
         既存の要素を書き換えた場合は、常にもとの名前空間が維持されます。

documentation/manual/ja/module_specs/Zend_Service_Amazon_Ec2-Keypair.xml

@@ -1,22 +1,26 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 20818 -->
 <sect1 id="zend.service.amazon.ec2.keypairs">
     <title>Zend_Service_Amazon_Ec2: Keypairs</title>
+
     <para>
         Keypairsはインスタンスにアクセスするために使われます。
     </para>
 
     <example id="zend.service.amazon.ec2.keypairs.create">
         <title>Amazon Keypairの新規作成</title>
+
         <para>
             <code>create</code>は、
             新しいインスタンスを開始するときに、2048ビットのRSAキー・ペアを新規作成して、
             このキー・ペアを参照文に引用するために使用できる一意のIDを返します。
         </para>
+
         <para>
             <code>create</code>はkeyName、keyFingerprint及びkeyMaterialを含む配列を返します。
         </para>
+
         <programlisting language="php"><![CDATA[
 $ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
 $return = $ec2_kp->create('my-new-key');
@@ -25,15 +29,18 @@ $return = $ec2_kp->create('my-new-key');
 
     <example id="zend.service.amazon.ec2.keypairs.delete">
         <title>Amazon Keypairの削除</title>
+
         <para>
             <code>delete</code>はキー・ペアを削除します。
             これは、それが新しいインスタンスで使われるのを防ぐだけです。
             keypairで現在実行中のインスタンスは、今まで通りそれらに接続可能です。
         </para>
+
         <para>
             <code>delete</code>はブール値の <constant>TRUE</constant>
             または <constant>FALSE</constant> を返します。
         </para>
+
         <programlisting language="php"><![CDATA[
 $ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
 $return = $ec2_kp->delete('my-new-key');
@@ -42,14 +49,17 @@ $return = $ec2_kp->delete('my-new-key');
 
     <example id="zend.service.amazon.ec2.describe">
         <title>Amazon Keypairの記述</title>
+
         <para>
             <code>describe</code>は、利用できるキー・ペアに関する情報を返します。
             キー・ペアを指定すると、それらのキー・ペアに関する情報が返されます。
             これ以外の場合には、登録したすべてのキー・ペアの情報が返されます。
         </para>
+
         <para>
             <code>describe</code>はkeyName及びkeyFingerprintを含む配列を返します。
         </para>
+
         <programlisting language="php"><![CDATA[
 $ec2_kp = new Zend_Service_Amazon_Ec2_Keypair('aws_key','aws_secret_key');
 $return = $ec2_kp->describe('my-new-key');

documentation/manual/ja/module_specs/Zend_Service_Amazon_Ec2-RegionsAndAvalibilityZones.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17948 -->
+<!-- EN-Revision: 20818 -->
 <sect1 id="zend.service.amazon.ec2.zones">
     <title>Zend_Service_Amazon_Ec2:リージョンおよび利用可能ゾーン</title>
 
@@ -16,12 +16,14 @@
 
     <sect2 id="zend.service.amazon.ec2.zones.regions">
         <title>アマゾンEC2リージョン</title>
+
         <para>
             必須条件を満たす場所で、アマゾンEC2インスタンスを開始できるように、
             アマゾンEC2は、複数のリージョンを提供します。
             たとえば、ヨーロッパの顧客とより親しいか、または法的要求を満たすために、
             ヨーロッパでインスタンスを開始したいかもしれません。
         </para>
+
         <para>
             アマゾンEC2リージョンは、
             他のアマゾンEC2リージョンからそれぞれ完全に分離されるように設計されています。
@@ -31,9 +33,11 @@
 
         <example id="zend.service.amazon.ec2.zones.regions.example">
             <title>利用可能リージョンを表示</title>
+
             <para>
                 <code>describe</code>は、アカウントがアクセスすべきリージョンを見つけるために使われます。
             </para>
+
             <para>
                 <code>describe</code>は、リージョンが利用できる情報を含む配列を返します。
                 各配列はregionNameおよびregionUrlを含みます。
@@ -52,6 +56,7 @@ foreach($regions as $region) {
 
     <sect2 id="zend.service.amazon.ec2.zones.availability">
         <title>アマゾンEC2利用可能ゾーン</title>
+
         <para>
             インスタンスを開始するとき、利用可能ゾーンを任意に指定できます。
             利用可能ゾーンを指定しなければ、アマゾンEC2はあなたが使用しているリージョン内で1つを選択します。
@@ -65,9 +70,11 @@ foreach($regions as $region) {
 
         <example id="zend.service.amazon.ec2.zones.availability.example">
             <title>利用可能ゾーンを表示</title>
+
             <para>
                 <code>describe</code>は、各利用可能ゾーンの状態を探すために使われます。
             </para>
+
             <para>
                 <code>describe</code>は、ゾーンが利用できる情報を含む配列を返します。
                 各配列はzoneNameおよびzoneStateを含みます。

documentation/manual/ja/module_specs/Zend_Service_Amazon_Ec2.xml

@@ -1,25 +1,30 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 20818 -->
 <sect1 id="zend.service.amazon.ec2" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Zend_Service_Amazon_Ec2</title>
 
     <sect2 id="zend.service.amazon.ec2.introduction">
         <title>導入</title>
+
         <para>
             <classname>Zend_Service_Amazon_Ec2</classname>は融通性のあるクランドコンピューティング(EC2)へのインターフェイスを提供します。
         </para>
     </sect2>
+
     <sect2 id="zend.service.amazon.ec2.whatis">
         <title>Amazon Ec2とは？</title>
+
         <para>
             Amazon EC2は、<acronym>API</acronym>や役に立つツールやユーティリティーを使って、
             Amazonのデータセンターにあるサーバインスタンスを起動したり管理したりできるWebサービスです。
             あなたはいつでも必要なだけ、合法な限り、Amazon EC2サーバインスタンスを使うことができます。
         </para>
     </sect2>
+
     <sect2 id="zend.service.amazon.ec2.staticmethods">
         <title>静的メソッド</title>
+
         <para>
             Ec2 クラスの使い勝手をよくするために、ふたつの静的メソッドが用意されています。
             これは、Ec2 の任意の要素から実行することができます。
@@ -28,12 +33,15 @@
             新しいオブジェクトを作成する際に、
             コンストラクタにキーを渡す必要がなくなります。
         </para>
+
         <example id="zend.service.amazon.ec2.staticmethods.setkeys">
             <title>setKeys() の例</title>
+
             <programlisting language="php"><![CDATA[
 Zend_Service_Amazon_Ec2_Ebs::setKeys('aws_key','aws_secret_key');
 ]]></programlisting>
         </example>
+
         <para>
             作業するリージョンを設定するには、<code>setRegion</code>
             をコールして Amazon Ec2 リージョンを設定します。
@@ -41,14 +49,18 @@ Zend_Service_Amazon_Ec2_Ebs::setKeys('aws_key','aws_secret_key');
             と eu-west-1 のふたつだけです。
             無効な値を渡した場合は例外をスローします。
         </para>
+
         <example id="zend.service.amazon.ec2.staticmethods.setregion">
             <title>setRegion() の例</title>
+
             <programlisting language="php"><![CDATA[
 Zend_Service_Amazon_Ec2_Ebs::setRegion('us-east-1');
 ]]></programlisting>
         </example>
+
         <note id="zend.service.amazon.ec2.staticmethods.setregion.note">
             <title>Amazon Ec2 リージョンの設定</title>
+
             <para>
                 別の方法として、各クラスを作成する際のコンストラクタの
                 3 番目の引数としてリージョンを設定することもできます。
@@ -56,4 +68,4 @@ Zend_Service_Amazon_Ec2_Ebs::setRegion('us-east-1');
         </note>
     </sect2>
 
-</sect1>
+</sect1>

documentation/manual/ja/module_specs/Zend_Translate-Using.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21194 -->
+<!-- EN-Revision: 21661 -->
 <sect1 id="zend.translate.using">
 
     <title>翻訳アダプタの使用法</title>
@@ -38,8 +38,19 @@ print "Here is line two\n";
     <example id="zend.translate.using.example2">
         <title>多言語対応の PHP コードの例</title>
         <programlisting language="php"><![CDATA[
-$translate = new Zend_Translate('gettext', '/my/path/source-de.mo', 'de');
-$translate->addTranslation('/path/to/translation/fr-source.mo', 'fr');
+$translate = new Zend_Translate(
+    array(
+        'adapter' => 'gettext',
+        'content' => '/my/path/source-de.mo',
+        'locale'  => 'de'
+    )
+);
+$translate->addTranslation(
+    array(
+        'content' => '/path/to/translation/fr-source.mo',
+        'locale'  => 'fr'
+    )
+);
 
 print $translate->_("Example") . "\n";
 print "=======\n";
@@ -62,10 +73,12 @@ print $translate->_("Here is line two") . "\n";
         新しい <classname>Zend_Translate</classname> オブジェクトを作成し、もととなるアダプタを定義します。
 
         <programlisting language="php"><![CDATA[
-$translate = new Zend_Translate
-    'gettext',
-    '/path/to/translation/source-de.mo',
-    'de'
+$translate = new Zend_Translate(
+    array(
+        'adapter' => 'gettext',
+        'content' => '/path/to/translation/source-de.mo',
+        'locale'  => 'de'
+    )
 );
 ]]></programlisting>
 

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

@@ -1,24 +1,66 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 21247 -->
 <sect2 id="zend.validate.set.hostname">
 
     <title>ホスト名</title>
 
     <para>
         <classname>Zend_Validate_Hostname</classname> は、ホスト名が仕様を満たしているかどうかの検証を行います。
-        三種類の形式のホスト名、つまりDNS ホスト名
+        三種類の形式のホスト名、つまり <acronym>DNS</acronym> ホスト名
         (たとえば domain.com)、IP アドレス (たとえば 1.2.3.4)
         そしてローカルホスト名 (たとえば localhost) の検証が可能です。
-        デフォルトでは DNS ホスト名のみが有効となります。
-    </para>
-
-    <para>
-        <emphasis>基本的な使用法</emphasis>
-    </para>
-
-    <para>
-       基本的な使用法は、以下のようになります。
+        デフォルトでは <acronym>DNS</acronym> ホスト名のみが有効となります。
+    </para>
+
+    <sect3 id="zend.validate.set.hostname.options">
+        <title>Supported options for Zend_Validate_Hostname</title>
+
+        <para>
+            The following options are supported for <classname>Zend_Validate_Hostname</classname>:
+        </para>
+ 
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis><property>allow</property></emphasis>: Defines the sort of hostname
+                    which is allowed to be used. See <link
+                        linkend="zend.validate.set.hostname.types">Hostname types</link> for
+                    details.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>idn</property></emphasis>: Defines if <acronym>IDN</acronym>
+                    domains are allowed or not. This option defaults to <constant>TRUE</constant>.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>ip</property></emphasis>: Allows to define a own IP
+                    validator. This option defaults to a new instance of
+                    <classname>Zend_Validate_Ip</classname>.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis><property>tld</property></emphasis>: Defines if
+                    <acronym>TLD</acronym>s are validated. This option defaults to
+                    <constant>TRUE</constant>.
+                </para>
+            </listitem>
+        </itemizedlist>
+    </sect3>
+
+    <sect3 id="zend.validate.set.hostname.basic">
+        <title>基本的な使用法</title>
+
+        <para>
+           基本的な使用法は、以下のようになります。
+        </para>
 
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname();
@@ -32,28 +74,31 @@ if ($validator->isValid($hostname)) {
 }
 ]]></programlisting>
 
-        これは、ホスト名 <varname>$hostname</varname> を検証し、失敗した場合は
-        その原因を表す便利なエラーメッセージを
-        <methodname>$validator->getMessages()</methodname> で取得します。
+        <para>
+            これは、ホスト名 <varname>$hostname</varname> を検証し、失敗した場合は
+            その原因を表す便利なエラーメッセージを
+            <methodname>$validator->getMessages()</methodname> で取得します。
+        </para>
 
-    </para>
+    </sect3>
 
-    <para>
-        <emphasis>さまざまな形式のホスト名の検証</emphasis>
-    </para>
+    <sect3 id="zend.validate.set.hostname.types">
+        <title>さまざまな形式のホスト名を検証</title>
 
-    <para>
-        IP アドレスやローカルホスト名、あるいはその両方を正しいホスト名として認めたいこともあるでしょう。
-        その場合は、<classname>Zend_Validate_Hostname</classname> のインスタンスを作成する際にパラメータを渡します。
-        このパラメータには、どの形式のホスト名を許可するのかを表す整数値を指定しなければなりません。
-        できるだけ、<classname>Zend_Validate_Hostname</classname> の定数を使用するようにしましょう。
-    </para>
+        <para>
+            IP アドレスやローカルホスト名、あるいはその両方を正しいホスト名として認めたいこともあるでしょう。
+            その場合は、<classname>Zend_Validate_Hostname</classname> のインスタンスを作成する際にパラメータを渡します。
+            このパラメータには、どの形式のホスト名を許可するのかを表す整数値を指定しなければなりません。
+            できるだけ、<classname>Zend_Validate_Hostname</classname> の定数を使用するようにしましょう。
+        </para>
+
+        <para>
+            <classname>Zend_Validate_Hostname</classname> の定数は次のとおりです。<constant>ALLOW_DNS</constant> は <acronym>DNS</acronym> ホスト名のみを許可し、
+            <constant>ALLOW_IP</constant> は IP アドレスを許可します。また <constant>ALLOW_LOCAL</constant>
+            はローカルネットワーク名を許可し、<constant>ALLOW_ALL</constant> はこれら三種類をすべて許可します。
+            IP アドレスだけをチェックするには、以下の例のようにします。
+        </para>
 
-    <para>
-        <classname>Zend_Validate_Hostname</classname> の定数は次のとおりです。<constant>ALLOW_DNS</constant> は DNS ホスト名のみを許可し、
-        <constant>ALLOW_IP</constant> は IP アドレスを許可します。また <constant>ALLOW_LOCAL</constant>
-        はローカルネットワーク名を許可し、<constant>ALLOW_ALL</constant> はこれら三種類をすべて許可します。
-        IP アドレスだけをチェックするには、以下の例のようにします。
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
 if ($validator->isValid($hostname)) {
@@ -65,45 +110,50 @@ if ($validator->isValid($hostname)) {
     }
 }
 ]]></programlisting>
-    </para>
 
-    <para>
-        <constant>ALLOW_ALL</constant> を使用してすべての形式を許可するほかに、
-        これらの形式を組み合わせることもできます。
-        たとえば、DNS およびローカルホスト名を許可するには、
-        <classname>Zend_Validate_Hostname</classname> のインスタンスを次のように作成します。
+        <para>
+            <constant>ALLOW_ALL</constant> を使用してすべての形式を許可するほかに、
+            これらの形式を組み合わせることもできます。
+            たとえば、 <acronym>DNS</acronym> およびローカルホスト名を許可するには、
+            <classname>Zend_Validate_Hostname</classname> のインスタンスを次のように作成します。
+        </para>
+
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS | Zend_Validate_Hostname::ALLOW_IP);]]></programlisting>
 
-    </para>
+    </sect3>
 
-    <para>
-        <emphasis>国際化ドメイン名の検証</emphasis>
-    </para>
+    <sect3 id="zend.validate.set.hostname.idn">
+        <title>国際化ドメイン名を検証</title>
 
-    <para>
-        国別コードトップレベルドメイン (Country Code Top Level Domains: ccTLDs)
-        の一部、たとえば 'de' (ドイツ) などでは、ドメイン名の中に国際化文字の使用をサポートしています。
-        これは、国際化ドメイン名 (International Domain Names: IDN) といわれるものです。
-        これらのドメインについても、<classname>Zend_Validate_Hostname</classname>
-        の検証プロセスで使用する文字を拡張することで検証できます。
-    </para>
+        <para>
+            国別コードトップレベルドメイン (Country Code Top Level Domains: ccTLDs)
+            の一部、たとえば 'de' (ドイツ) などでは、ドメイン名の中に国際化文字の使用をサポートしています。
+            これは、国際化ドメイン名 (International Domain Names: <acronym>IDN</acronym>) といわれるものです。
+            これらのドメインについても、<classname>Zend_Validate_Hostname</classname>
+            の検証プロセスで使用する文字を拡張することで検証できます。
+        </para>
 
-    <para>
-        これまでに、50以上の ccTLD が IDN ドメインをサポートします。
-    </para>
+        <note>
+            <title>IDN ドメイン</title>
 
-    <para>
-        IDN ドメインに対するマッチングを行う方法は、通常のホスト名の場合とまったく同じです。
-        というのも、IDN のマッチングはデフォルトで有効になっているからです。
-        IDN の検証を無効にしたい場合は、<classname>Zend_Validate_Hostname</classname>
-        のコンストラクタにパラメータを渡すか、あるいは
-        <methodname>setValidateIdn()</methodname> メソッドを使用します。
-    </para>
+            <para>
+                これまでに、50以上の ccTLD が <acronym>IDN</acronym> ドメインをサポートします。
+            </para>
+        </note>
 
-    <para>
-        IDN の検証を無効にするには、<classname>Zend_Validate_Hostname</classname>
-        のコンストラクタに二番目のパラメータを次のように渡します。
+        <para>
+            <acronym>IDN</acronym> ドメインに対するマッチングを行う方法は、通常のホスト名の場合とまったく同じです。
+            というのも、 <acronym>IDN</acronym> のマッチングはデフォルトで有効になっているからです。
+            <acronym>IDN</acronym> の検証を無効にしたい場合は、<classname>Zend_Validate_Hostname</classname>
+            のコンストラクタにパラメータを渡すか、あるいは
+            <methodname>setValidateIdn()</methodname> メソッドを使用します。
+        </para>
+
+        <para>
+            <acronym>IDN</acronym> の検証を無効にするには、<classname>Zend_Validate_Hostname</classname>
+            のコンストラクタに二番目のパラメータを次のように渡します。
+        </para>
 
         <programlisting language="php"><![CDATA[
 $validator =
@@ -115,29 +165,34 @@ $validator =
     );
 ]]></programlisting>
 
-        あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
-        <methodname>setValidateIdn()</methodname> に渡すことで、
-        IDN の検証を有効あるいは無効にすることもできます。
-
-        現在サポートされていない IDN ホスト名に対するマッチングを行おうとすると、
-        国際化文字が含まれている場合に検証に失敗します。
-        追加の文字を指定した ccTLD ファイルが Zend/Validate/Hostname
-        に存在しない場合は、通常のホスト名の検証を行います。
-    </para>
-
-    <para>
-        IDN の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
-    </para>
-
-    <para>
-        <emphasis>トップレベルドメインの検証</emphasis>
-    </para>
-
-    <para>
-        デフォルトでは、ホスト名の検証は既知の TLD の一覧に基づいて行われます。
-        この機能が不要な場合は、IDN サポートを無効にするのと同じ方法で無効にできます。
-        TLD の検証を無効にするには、<classname>Zend_Validate_Hostname</classname> のコンストラクタに三番目のパラメータを渡します。
-        以下の例では、IDN の検証は二番目のパラメータで有効にしています。
+        <para>
+            あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
+            <methodname>setValidateIdn()</methodname> に渡すことで、
+            <acronym>IDN</acronym> の検証を有効あるいは無効にすることもできます。
+            現在サポートされていない <acronym>IDN</acronym> ホスト名に対するマッチングを行おうとすると、
+            国際化文字が含まれている場合に検証に失敗します。
+            追加の文字を指定した ccTLD ファイルが <filename>Zend/Validate/Hostname</filename>
+            に存在しない場合は、通常のホスト名の検証を行います。
+        </para>
+
+        <note>
+            <title>IDN 検証</title>
+
+            <para>
+                <acronym>IDN</acronym> の検証は、 <acronym>DNS</acronym> ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.validate.set.hostname.tld">
+        <title>トップレベルドメインを検証</title>
+
+        <para>
+            デフォルトでは、ホスト名の検証は既知の <acronym>TLD</acronym> の一覧に基づいて行われます。
+            この機能が不要な場合は、 <acronym>IDN</acronym> サポートを無効にするのと同じ方法で無効にできます。
+            <acronym>TLD</acronym> の検証を無効にするには、<classname>Zend_Validate_Hostname</classname> のコンストラクタに三番目のパラメータを渡します。
+            以下の例では、 <acronym>IDN</acronym> の検証は二番目のパラメータで有効にしています。
+        </para>
 
         <programlisting language="php"><![CDATA[
 $validator =
@@ -150,15 +205,20 @@ $validator =
     );
 ]]></programlisting>
 
-        あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
-        <methodname>setValidateIdn()</methodname> に渡すことで、
-        TLD の検証を有効あるいは無効にすることもできます。
-    </para>
+        <para>
+            あるいは、 <constant>TRUE</constant> または <constant>FALSE</constant> を
+            <methodname>setValidateIdn()</methodname> に渡すことで、
+            <acronym>TLD</acronym> の検証を有効あるいは無効にすることもできます。
+        </para>
 
-    <para>
-        TLD の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
-    </para>
+        <note>
+            <title>TLD 検証</title>
 
+            <para>
+                <acronym>TLD</acronym> の検証は、 <acronym>DNS</acronym> ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
+            </para>
+        </note>
+    </sect3>
 </sect2>
 <!--
 vim:se ts=4 sw=4 et:

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21213 -->
+<!-- EN-Revision: 21661 -->
 <sect1 id="zend.validate.messages">
 
     <title>検証メッセージ</title>
@@ -8,7 +8,6 @@
     <para>
         <classname>Zend_Validate</classname> を継承したバリデータには、
         検証に失敗したときに使用するメッセージが用意されています。
-        <!-- TODO : to be translated -->
         You can use this information to set your own messages,
         or to translate existing messages which a validator could return to something different.
     </para>
@@ -82,10 +81,12 @@ $validator->setMessage('Please enter a lower value', Zend_Validate_GreaterThan::
 
         <programlisting language="php"><![CDATA[
 $translator = new Zend_Translate(
-    'array',
-    '/resources/languages',
-    $language,
-    array('scan' => Zend_Translate::LOCALE_DIRECTORY)
+    array(
+        'adapter' => 'array',
+        'content' => '/resources/languages',
+        'locale'  => $language,
+        'scan' => Zend_Translate::LOCALE_DIRECTORY
+    )
 );
 Zend_Validate_Abstract::setDefaultTranslator($translator);
 ]]></programlisting>

documentation/manual/ja/module_specs/Zend_Validate.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21194 -->
+<!-- EN-Revision: 21661 -->
 <sect1 id="zend.validate.introduction">
 
     <title>導入</title>
@@ -320,9 +320,13 @@ iif (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
         <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_StringLength(array('min' => 8, 'max' => 12));
 $translate = new Zend_Translate(
-    'array',
-    array(Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''),
-    'en'
+    array(
+        'adapter' => 'array',
+        'content' => array(
+            Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''
+        ),
+        'locale' => 'en'
+    )
 );
 
 $validator->setTranslator($translate);
@@ -338,9 +342,13 @@ $validator->setTranslator($translate);
 
         <programlisting language="php"><![CDATA[
 $translate = new Zend_Translate(
-    'array',
-    array(Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''),
-    'en'
+    array(
+        'adapter' => 'array',
+        'content' => array(
+            Zend_Validate_StringLength::TOO_SHORT => 'Translated \'%value%\''
+        ),
+        'locale' => 'en'
+    )
 );
 Zend_Validate::setDefaultTranslator($translate);
 ]]></programlisting>

documentation/manual/ja/module_specs/Zend_View-Helpers-Translate.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19433 -->
+<!-- EN-Revision: 21661 -->
 <sect3 id="zend.view.helpers.initial.translate">
 
     <title>翻訳ヘルパー</title>
@@ -66,7 +66,13 @@
 
         <programlisting language="php"><![CDATA[
 // サンプルアダプタ
-$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');
+$adapter = new Zend_Translate(
+    array(
+        'adapter' => 'array',
+        'content' => array('simple' => 'einfach'),
+        'locale'  => 'de'
+    )
+);
 Zend_Registry::set('Zend_Translate', $adapter);
 
 // ビューの中で
@@ -94,7 +100,13 @@ echo $this->translate('simple');
 
         <programlisting language="php"><![CDATA[
 // ビューの中で
-$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');
+$adapter = new Zend_Translate(
+    array(
+        'adapter' => 'array',
+        'content' => array('simple' => 'einfach'),
+        'locale'  => 'de'
+    )
+);
 $this->translate()->setTranslator($adapter)->translate('simple');
 // これは 'einfach' を返します
 ]]></programlisting>
@@ -112,7 +124,13 @@ $this->translate()->setTranslator($adapter)->translate('simple');
 
         <programlisting language="php"><![CDATA[
 // サンプルアダプタ
-$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');
+$adapter = new Zend_Translate(
+    array(
+        'adapter' => 'array',
+        'content' => array('simple' => 'einfach'),
+        'locale'  => 'de'
+    )
+);
 
 // アダプタを初期化します
 $translate = new Zend_View_Helper_Translate($adapter);

documentation/manual/ja/ref/migration-110.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21076 -->
+<!-- EN-Revision: 21661 -->
 <sect1 id="migration.110">
     <title>Zend Framework 1.10</title>
 
@@ -244,7 +244,9 @@ $authors = $feed->getAuthors()->getValues();
             </para>
 
             <programlisting language="php"><![CDATA[
-$trans = new Zend_Translate('xliff', '/path/to/source', $locale, array('useId' => false));
+$trans = new Zend_Translate(
+    'xliff', '/path/to/source', $locale, array('useId' => false)
+);
 ]]></programlisting>
         </sect3>
     </sect2>