sync Japanese document with r15666.

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 15666 -->
 <sect1 id="zend.locale.functions">
 
     <title>Zend_Locale の使用法</title>
@@ -240,9 +240,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry>
                           地域化された全言語の一覧を返します。
                           ロケールの言語部分がキー、そしてその翻訳が値となります。
-                          利便性のために
-                          <code>getLanguageTranslationList()</code>
-                          メソッドも使用することが可能です。
                         </entry>
                     </row>
                     <row>
@@ -250,9 +247,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry>
                           地域化された全文字の一覧を返します。
                           ロケールの文字部分がキー、そしてその翻訳が値となります。
-                          利便性のために
-                          <code>getScriptTranslationList()</code>
-                          メソッドも使用することが可能です。
                         </entry>
                     </row>
                     <row>
@@ -264,10 +258,7 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                           国のみを取得するには値として '2' を使用します。
                           可能な場合、ロケールの国部分をキーとして使用します。
                           それ以外の場合は、この領域が使用している公式 ISO コードをキーとして使用します。
-                          領域を翻訳したものが値となります。利便性のために、
-                          すべての国を取得する <code>getCountryTranslationList()</code>
-                          メソッドとすべての領域 (国以外) を取得する
-                          <code>getTerritoryTranslationList()</code> メソッドが用意されています。
+                          領域を翻訳したものが値となります。
                           値を省略した場合は、両方の一覧を取得します。
                         </entry>
                     </row>
@@ -718,6 +709,14 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                             そして領域 (地域) が配列の値となります。
                         </entry>
                     </row>
+                    <row>
+                        <entry><emphasis>PostalToTerritory</emphasis></entry>
+                        <entry>
+                            その郵便番号が使われている領域の一覧を正規表現で返します。
+                            ISO 領域コード ('territory') が配列のキー、
+                            そして正規表現が配列の値となります。
+                        </entry>
+                    </row>
                 </tbody>
             </tgroup>
         </table>
@@ -757,9 +756,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry>
                           言語の翻訳を返します。
                           希望通りの翻訳を選択するために、言語コードを値として指定する必要があります。
-                          利便性のために
-                          <code>getLanguageTranslation($value)</code>
-                          メソッドも使用することが可能です。
                         </entry>
                     </row>
                     <row>
@@ -767,9 +763,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry>
                           文字の翻訳を返します。
                           希望通りの翻訳を選択するために、文字コードを値として指定する必要があります。
-                          利便性のために
-                          <code>getScriptTranslation($value)</code>
-                          メソッドも使用することが可能です。
                         </entry>
                     </row>
                     <row>
@@ -779,9 +772,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                           領域の翻訳を返します。
                           これは国、大陸および領域のいずれかとなります。
                           希望通りの翻訳を選択するために、領域コードを値として指定する必要があります。
-                          利便性のために
-                          <code>getCountryTranslation($value)</code>
-                          メソッドも使用することが可能です。
                         </entry>
                     </row>
                     <row>
@@ -801,12 +791,6 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         </entry>
                     </row>
                     <row>
-                        <entry><emphasis>DateChars</emphasis></entry>
-                        <entry>
-                          日付の表示に使用するすべての文字を含む文字テーブルを返します。
-                        </entry>
-                    </row>
-                    <row>
                         <entry><emphasis>DefaultCalendar</emphasis></entry>
                         <entry>
                           指定したロケールにおけるデフォルトの暦を返します。
@@ -1282,6 +1266,14 @@ print Zend_Locale::getTranslation('de', 'language', 'zh');
                         <entry><emphasis>TerritoryToAlpha3</emphasis></entry>
                         <entry>3 桁の文字コードに対応する領域 (地域) を返します。</entry>
                     </row>
+                    <row>
+                        <entry><emphasis>PostalToTerritory</emphasis></entry>
+                        <entry>
+                            指定した領域に対応する郵便番号の正規表現を返します。
+                            領域は ISO4217 形式の文字列で指定する必要があります。
+                            たとえば世界全体は '001' となります。
+                        </entry>
+                    </row>
                 </tbody>
             </tgroup>
         </table>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 15666 -->
 <sect1 id="zend.locale.migration">
 
     <title>以前のバージョンからの移行</title>
@@ -12,6 +12,71 @@
         新しい API にあわせましょう。
     </para>
 
+    <sect2 id="zend.locale.migration.fromoneeighttoonenine">
+        <title>1.8 から 1.9 以降への移行</title>
+        <sect3 id="zend.locale.migration.fromoneeighttoonenine.depreciated">
+            <title>非推奨となるメソッド</title>
+
+            <para>
+                特別に用意されていたメソッドのいくつかが非推奨となります。
+                既存の挙動と重複しているからです。
+                古いメソッドも動作するにはしますが、
+                新しいメソッドについて説明する user notice が発生することに注意しましょう。
+                これらのメソッドは 2.0 で削除されます。
+                次の一覧で、新旧のメソッドコールを参照ください。
+            </para>
+
+            <table id="zend.locale.migration.fromoneeighttoonenine.depreciated.table-1">
+
+                <title>新旧のメソッドコールの一覧</title>
+
+                <tgroup cols="2">
+                    <thead>
+                        <row>
+                            <entry>古い方法</entry>
+                            <entry>新しい方法</entry>
+                        </row>
+                    </thead>
+                    <tbody>
+                        <row>
+                            <entry>getLanguageTranslationList($locale)</entry>
+                            <entry>getTranslationList('language', $locale)</entry>
+                        </row>
+                        <row>
+                            <entry>getScriptTranslationList($locale)</entry>
+                            <entry>getTranslationList('script', $locale)</entry>
+                        </row>
+                        <row>
+                            <entry>getCountryTranslationList($locale)</entry>
+                            <entry>getTranslationList('territory', $locale, 2)</entry>
+                        </row>
+                        <row>
+                            <entry>getTerritoryTranslationList($locale)</entry>
+                            <entry>getTranslationList('territory', $locale, 1)</entry>
+                        </row>
+                        <row>
+                            <entry>getLanguageTranslation($value, $locale)</entry>
+                            <entry>getTranslation($value, 'language', $locale)</entry>
+                        </row>
+                        <row>
+                            <entry>getScriptTranslation($value, $locale)</entry>
+                            <entry>getTranslation($value, 'script', $locale)</entry>
+                        </row>
+                        <row>
+                            <entry>getCountryTranslation($value, $locale)</entry>
+                            <entry>getTranslation($value, 'country', $locale)</entry>
+                        </row>
+                        <row>
+                            <entry>getTerritoryTranslation($value, $locale)</entry>
+                            <entry>getTranslation($value, 'territory', $locale)</entry>
+                        </row>
+                    </tbody>
+                </tgroup>
+            </table>
+
+        </sect3>
+    </sect2>
+
     <sect2 id="zend.locale.migration.fromonesixtooneseven">
         <title>1.6 から 1.7 以降への移行</title>
         <sect3 id="zend.locale.migration.fromonesixtooneseven.islocale">