[DOCUMENTATION]Japanese sync

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

documentation/manual/ja/module_specs/Zend_Loader.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17175 -->
+<!-- EN-Revision: 20243 -->
 <sect1 id="zend.loader.load">
 
     <title>ファイルやクラスの動的な読み込み</title>
@@ -31,7 +31,7 @@
             このメソッドは <acronym>PHP</acronym> 関数
             <ulink url="http://php.net/include"><methodname>include()</methodname></ulink>
             のラッパーで、失敗した場合 (たとえば指定したファイルが存在しないなど)
-            には false を返します。
+            には <constant>FALSE</constant> を返します。
         </para>
 
         <example id="zend.loader.load.file.example">
@@ -115,6 +115,73 @@ Zend_Loader::loadClass('Container_Tree',
             英数字とハイフン ('-')、アンダースコア ('_') そしてピリオド ('.') だけです。
         </para>
 
+        <!-- TODO : to be translated -->
+        <note>
+            <title>Loading Classes from PHP Namespaces</title>
+
+            <para>
+                Starting in version 1.10.0, Zend Framework now allows loading classes from PHP
+                namespaces. This support follows the same guidelines and implementation as that
+                found in the <ulink
+                    url="http://groups.google.com/group/php-standards/web/psr-0-final-proposal">PHP
+                Framework Interop Group PSR-0</ulink> reference implementation.
+            </para>
+
+            <para>
+                Under this guideline, the following rules apply:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        Each namespace separator is converted to a
+                        <constant>DIRECTORY_SEPARATOR</constant> when loading from the file system.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        Each "_" character in the <emphasis>CLASS NAME</emphasis> is converted to a
+                        <constant>DIRECTORY_SEPARATOR</constant>.  The "_" character has no special
+                        meaning in the namespace.
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        The fully-qualified namespace and class is suffixed with ".php" when loading
+                        from the file system.
+                    </para>
+                </listitem>
+            </itemizedlist>
+
+            <para>
+                As examples:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <classname>\Doctrine\Common\IsolatedClassLoader</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/Doctrine/Common/IsolatedClassLoader.php</filename>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <classname>\namespace\package\Class_Name</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/namespace/package/Class/Name.php</filename>
+                    </para>
+                </listitem>
+
+                <listitem>
+                    <para>
+                        <classname>\namespace\package_name\Class_Name</classname> =&gt;
+                        <filename>/path/to/project/lib/vendor/namespace/package_name/Class/Name.php</filename>
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </note>
     </sect2>
 
     <sect2 id="zend.loader.load.isreadable">
@@ -178,7 +245,7 @@ Zend_Loader::registerAutoload();
 
         <para>
             <classname>Zend_Loader</classname> クラスを継承した場合は、<methodname>registerAutoload()</methodname>
-            に引数を追加することができます。この引数で、どのクラスから
+            に引数を追加できます。この引数で、どのクラスから
             <methodname>autoload()</methodname> メソッドを登録するのかを指定します。
         </para>
 

documentation/manual/ja/module_specs/Zend_Pdf-Drawing.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17227 -->
+<!-- EN-Revision: 20469 -->
 <sect1 id="zend.pdf.drawing">
     <title>描画</title>
 
@@ -27,7 +27,7 @@ $height = $pdfPage->getHeight();
         <acronym>PDF</acronym> には、色を表現するためのさまざまな方法があります。<classname>Zend_Pdf</classname> では、
         グレイスケール、RGB および CMYK 色空間をサポートしています。
         <classname>Zend_Pdf_Color</classname> オブジェクトが要求される箇所では、
-        これらのどれでも使用することができます。それぞれの色空間に対応する機能を提供するのが
+        これらのどれでも使用できます。それぞれの色空間に対応する機能を提供するのが
         <classname>Zend_Pdf_Color_GrayScale</classname>、<classname>Zend_Pdf_Color_Rgb</classname> および
         <classname>Zend_Pdf_Color_Cmyk</classname> クラスです。
         </para>
@@ -91,6 +91,31 @@ public function drawLine($x1, $y1, $x2, $y2);
 public function drawRectangle($x1, $y1, $x2, $y2,
                     $fillType = Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE);
 ]]></programlisting>
+        <!-- TODO : to be translated -->
+        <programlisting language="php"><![CDATA[
+/**
+ * Draw a rounded rectangle.
+ *
+ * Fill types:
+ * Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE - fill rectangle and stroke (default)
+ * Zend_Pdf_Page::SHAPE_DRAW_STROKE      - stroke rectangle
+ * Zend_Pdf_Page::SHAPE_DRAW_FILL        - fill rectangle
+ *
+ * radius is an integer representing radius of the four corners, or an array
+ * of four integers representing the radius starting at top left, going
+ * clockwise
+ *
+ * @param float $x1
+ * @param float $y1
+ * @param float $x2
+ * @param float $y2
+ * @param integer|array $radius
+ * @param integer $fillType
+ * @return Zend_Pdf_Page
+ */
+public function drawRoundedRectangle($x1, $y1, $x2, $y2, $radius, 
+                       $fillType = Zend_Pdf_Page::SHAPE_DRAW_FILL_AND_STROKE);
+]]></programlisting>
         <programlisting language="php"><![CDATA[
 /**
  * 多角形を描画します。
@@ -182,7 +207,7 @@ public function drawEllipse($x1,
         <para>
         テキストに対する描画操作も、<acronym>PDF</acronym> のページに対して行われます。
         ベースラインの x 座標および y 座標を指定することで、
-        ページ内の任意の場所にテキストを 1 行描画することができます。
+        ページ内の任意の場所にテキストを 1 行描画できます。
         現在のフォントおよびフォントサイズを使用して、描画操作が行われます
         (詳細は、以下を参照ください)。
         </para>
@@ -213,7 +238,7 @@ $pdfPage->drawText('Hello world!', 72, 720);
         テキストの文字列が解釈されます。異なるエンコーディングを使用している場合
         (例えば、ディスク上のファイルから UTF-8 の文字列を読み込んだり
         レガシーなデータベースから MacRoman の文字列を取得したりなど) は、
-        描画の際に文字エンコーディングを指定することができます。
+        描画の際に文字エンコーディングを指定できます。
         そうすることで、<classname>Zend_Pdf</classname> が変換処理を行います。<acronym>PHP</acronym> の
         <code><ulink url="http://www.php.net/manual/function.iconv.php">iconv()</ulink></code>
         関数がサポートしているエンコーディングなら、すべて入力として使用することが可能です。
@@ -350,7 +375,7 @@ $pdfPage->setFont($goodDogCoolFont, 36);
         デフォルトでは、独自のフォントは <acronym>PDF</acronym> ドキュメントに埋め込まれます。
         そのため、閲覧者のシステムにそのフォントがインストールされていなくても、
         ページをきちんと閲覧できるようになります。ファイルの大きさが気になる場合は、
-        ファクトリーメソッドのオプションで「フォントを埋め込まない」ことを指定することができます。
+        ファクトリーメソッドのオプションで「フォントを埋め込まない」ことを指定できます。
         </para>
         <example id="zend.pdf.drawing.using-fonts.example-3">
             <title>TrueType を作成するが、PDF ドキュメントには埋め込まない</title>
@@ -398,7 +423,7 @@ $font = Zend_Pdf_Font::fontWithPath(
         <para>
         フォントのサイズは比較的大きく、中には 10 メガバイトに達するものもあります。
         デフォルトでは埋め込みフォントは Flate 圧縮され、平均して 50% ほどサイズを節約できます。
-        何らかの理由でフォントを圧縮したくない場合は、以下のオプションで圧縮を無効にすることができます。
+        何らかの理由でフォントを圧縮したくない場合は、以下のオプションで圧縮を無効にできます。
         </para>
         <example id="zend.pdf.drawing.using-fonts.example-5">
             <title>埋め込みフォントを圧縮しない</title>
@@ -668,7 +693,7 @@ public function setLineDashingPattern($pattern, $phase = 0);
 
         <para>
         <methodname>Zend_Pdf_Page::drawPolygon()</methodname> メソッドには、さらにパラメータ
-        <varname>$fillMethod</varname> を指定することができます。
+        <varname>$fillMethod</varname> を指定できます。
         </para>
         <itemizedlist>
             <listitem>
@@ -810,7 +835,7 @@ public function skew($x, $y, $xAngle, $yAngle);
         <para>
         好きな時点でのグラフィックの状態
         (現在のフォント、フォントサイズ、線の色、塗りつぶしの色、線の形式、
-        ページの回転、クリップ領域) を保存/復元することができます。
+        ページの回転、クリップ領域) を保存/復元できます。
         保存操作はグラフィックの状態をスタックに保存し、復元の際にはそこから取り出されます。
         </para>
         <para>

documentation/manual/ja/module_specs/Zend_Queue-Adapters.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19320 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="zend.queue.adapters">
     <title>アダプタ</title>
 
@@ -558,7 +558,7 @@ $queue = new Zend_Queue('Db', $options);
                                     <para>
                                         <varname>preserved</varname> - ジョブ・キュー・ヒストリの
                                         内部でジョブを保持するべきかどうか。デフォルトはoff。
-                                        保持するためには、true値を渡します。
+                                        保持するためには、 <constant>TRUE</constant> を渡します。
                                     </para>
                                 </listitem>
 
@@ -599,7 +599,7 @@ $queue = new Zend_Queue('Db', $options);
                                 <listitem>
                                     <para>
                                         <varname>application_id</varname> - ジョブのアプリケーション識別子。
-                                        デフォルトでnullで、キューがアプリケーションIDを割り当てられたら、
+                                        デフォルトは <constant>NULL</constant> で、キューがアプリケーションIDを割り当てられたら、
                                         アプリケーションIDがキューによって自動的に割り当てられることを
                                         示します。
                                     </para>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18942 -->
+<!-- EN-Revision: 20352 -->
 <sect1 id="zend.validate.messages">
 
     <title>検証メッセージ</title>
@@ -8,573 +8,113 @@
     <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>
 
-    <table id="zend.validate.messages.table">
-        <title>利用可能な検証メッセージ</title>
-        <tgroup cols="3">
-            <thead>
-                <row>
-                    <entry>バリデータ</entry>
-                    <entry>定数</entry>
-                    <entry>メッセージ</entry>
-                </row>
-            </thead>
-            <tbody>
-                <row>
-                    <entry morerows="1" valign="middle">Alnum</entry>
-                    <entry><constant>NOT_ALNUM</constant></entry>
-                    <entry>'%value%' has not only alphabetic and digit characters</entry>
-                </row>
-                <row>
-                    <entry><constant>STRING_EMPTY</constant></entry>
-                    <entry>'%value%' is an empty string</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Alpha</entry>
-                    <entry><constant>NOT_ALPHA</constant></entry>
-                    <entry>'%value%' has not only alphabetic characters</entry>
-                </row>
-                <row>
-                    <entry><constant>STRING_EMPTY</constant></entry>
-                    <entry>'%value%' is an empty string</entry>
-                </row>
-                <row>
-                    <entry>Barcode</entry>
-                    <entry>---</entry>
-                    <entry>messages are thrown by a subclass</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">Barcode_Ean13</entry>
-                    <entry><constant>INVALID</constant></entry>
-                    <entry>'%value%' is an invalid <constant>EAN</constant>-13 barcode</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_LENGTH</constant></entry>
-                    <entry>'%value%' should be 13 characters</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_NUMERIC</constant></entry>
-                    <entry>'%value%' should contain only numeric characters</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Barcode_UpcA</entry>
-                    <entry><constant>INVALID</constant></entry>
-                    <entry>'%value%' is an invalid <constant>UPC</constant>-A barcode</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_LENGTH</constant></entry>
-                    <entry>'%value%' should be 12 characters</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Between</entry>
-                    <entry><constant>NOT_BETWEEN</constant></entry>
-                    <entry>'%value%' is not between '%min%' and '%max%', inclusively</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_BETWEEN_STRICT</constant></entry>
-                    <entry>'%value%' is not strictly between '%min%' and '%max%'</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Ccnum</entry>
-                    <entry><constant>LENGTH</constant></entry>
-                    <entry>'%value%' must contain between 13 and 19 digits</entry>
-                </row>
-                <row>
-                    <entry><constant>CHECKSUM</constant></entry>
-                    <entry>Luhn algorithm (mod-10 checksum) failed on '%value%'</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Date</entry>
-                    <entry><constant>FALSEFORMAT</constant></entry>
-                    <entry>'%value%' does not fit given date format</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID</constant></entry>
-                    <entry>'%value%' does not appear to be a valid date</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Db_Abstract</entry>
-                    <entry><constant>ERROR_NO_RECORD_FOUND</constant></entry>
-                    <entry>No record matching %value% was found</entry>
-                </row>
-                <row>
-                    <entry><constant>ERROR_RECORD_FOUND</constant></entry>
-                    <entry>A record matching %value% was found</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Digits</entry>
-                    <entry><constant>NOT_DIGITS</constant></entry>
-                    <entry>'%value%' contains not only digit characters</entry>
-                </row>
-                <row>
-                    <entry><constant>STRING_EMPTY</constant></entry>
-                    <entry>'%value%' is an empty string</entry>
-                </row>
-                <row>
-                    <entry morerows="7" valign="middle">EmailAddress</entry>
-                    <entry><constant>INVALID</constant></entry>
-                    <entry>
-                        '%value%' is not a valid email address in the basic format
-                        local-part@hostname
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_FORMAT</constant></entry>
-                    <entry>'%value%' is not a valid email address in the basic format local-part@hostname</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_HOSTNAME</constant></entry>
-                    <entry>'%hostname%' is not a valid hostname for email address '%value%'</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_MX_RECORD</constant></entry>
-                    <entry>
-                        '%hostname%' does not appear to have a valid MX record for the email address
-                        '%value%'
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>DOT_ATOM</constant></entry>
-                    <entry>'%localPart%' not matched against dot-atom format</entry>
-                </row>
-                <row>
-                    <entry><constant>QUOTED_STRING</constant></entry>
-                    <entry>'%localPart%' not matched against quoted-string format</entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_LOCAL_PART</constant></entry>
-                    <entry>
-                        '%localPart%' is not a valid local part for email address '%value%'
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>LENGTH_EXCEEDED</constant></entry>
-                    <entry>'%value%' exceeds the allowed length</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">File_Count</entry>
-                    <entry><constant>TOO_MUCH</constant></entry>
-                    <entry>
-                        Too much files, maximum '%max%' are allowed but '%count%' are given
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>TOO_LESS</constant></entry>
-                    <entry>
-                        Too less files, minimum '%min%' are expected but '%count%' are given
-                    </entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_Crc32</entry>
-                    <entry><constant>DOES_NOT_MATCH</constant></entry>
-                    <entry>The file '%value%' does not match the given crc32 hashes</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>There was no crc32 hash detected for the given file</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">File_ExcludeExtension</entry>
-                    <entry><constant>FALSE_EXTENSION</constant></entry>
-                    <entry>The file '%value%' has a false extension</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' was not found</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_ExcludeMimeType</entry>
-                    <entry><constant>FALSE_TYPE</constant></entry>
-                    <entry>The file '%value%' has a false mimetype of '%type%'</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>The mimetype of file '%value%' could not been detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>The file '%value%' can not be read</entry>
-                </row>
-                <row>
-                    <entry>File_Exists</entry>
-                    <entry><constant>DOES_NOT_EXIST</constant></entry>
-                    <entry>The file '%value%' does not exist</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">File_Extension</entry>
-                    <entry><constant>FALSE_EXTENSION</constant></entry>
-                    <entry>The file '%value%' has a false extension</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' was not found</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_FilesSize</entry>
-                    <entry><constant>TOO_BIG</constant></entry>
-                    <entry>
-                        All files in sum should have a maximum size of '%max%' but '%size%' were
-                        detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>TOO_SMALL</constant></entry>
-                    <entry>
-                        All files in sum should have a minimum size of '%min%' but '%size%' were
-                        detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>One or more files can not be read</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_Hash</entry>
-                    <entry><constant>DOES_NOT_MATCH</constant></entry>
-                    <entry>The file '%value%' does not match the given hashes</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>There was no hash detected for the given file</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry morerows="5" valign="middle">File_ImageSize</entry>
-                    <entry><constant>WIDTH_TOO_BIG</constant></entry>
-                    <entry>
-                        Maximum allowed width for image '%value%' should be '%maxwidth%' but
-                        '%width%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>WIDTH_TOO_SMALL</constant></entry>
-                    <entry>
-                        Minimum expected width for image '%value%' should be '%minwidth%' but
-                        '%width%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>HEIGHT_TOO_BIG</constant></entry>
-                    <entry>
-                        Maximum allowed height for image '%value%' should be '%maxheight%' but
-                        '%height%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>HEIGHT_TOO_SMALL</constant></entry>
-                    <entry>
-                        Minimum expected height for image '%value%' should be '%minheight%' but
-                        '%height%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>The size of image '%value%' could not be detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>The image '%value%' can not be read</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_IsCompressed</entry>
-                    <entry><constant>FALSE_TYPE</constant></entry>
-                    <entry>The file '%value%' is not compressed, '%type%' detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>The mimetype of file '%value%' could not been detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>The file '%value%' can not be read</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_IsImage</entry>
-                    <entry><constant>FALSE_TYPE</constant></entry>
-                    <entry>The file '%value%' is no image, '%type%' detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>The mimetype of file '%value%' could not been detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>The file '%value%' can not be read</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_Md5</entry>
-                    <entry><constant>DOES_NOT_MATCH</constant></entry>
-                    <entry>The file '%value%' does not match the given md5 hashes</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>There was no md5 hash detected for the given file</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_MimeType</entry>
-                    <entry><constant>FALSE_TYPE</constant></entry>
-                    <entry>The file '%value%' has a false mimetype of '%type%'</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>The mimetype of file '%value%' could not been detected</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_READABLE</constant></entry>
-                    <entry>The file '%value%' can not be read</entry>
-                </row>
-                <row>
-                    <entry>File_NotExists</entry>
-                    <entry><constant>DOES_EXIST</constant></entry>
-                    <entry>The file '%value%' does exist</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_Sha1</entry>
-                    <entry><constant>DOES_NOT_MATCH</constant></entry>
-                    <entry>The file '%value%' does not match the given sha1 hashes</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_DETECTED</constant></entry>
-                    <entry>There was no sha1 hash detected for the given file</entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_Size</entry>
-                    <entry><constant>TOO_BIG</constant></entry>
-                    <entry>
-                        Maximum allowed size for file '%value%' is '%max%' but '%size%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>TOO_SMALL</constant></entry>
-                    <entry>
-                        Minimum expected size for file '%value%' is '%min%' but '%size%' detected
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry morerows="9" valign="middle">File_Upload</entry>
-                    <entry><constant>INI_SIZE</constant></entry>
-                    <entry>The file '%value%' exceeds the defined ini size</entry>
-                </row>
-                <row>
-                    <entry><constant>FORM_SIZE</constant></entry>
-                    <entry>The file '%value%' exceeds the defined form size</entry>
-                </row>
-                <row>
-                    <entry><constant>PARTIAL</constant></entry>
-                    <entry>The file '%value%' was only partially uploaded</entry>
-                </row>
-                <row>
-                    <entry><constant>NO_FILE</constant></entry>
-                    <entry>The file '%value%' was not uploaded</entry>
-                </row>
-                <row>
-                    <entry><constant>NO_TMP_DIR</constant></entry>
-                    <entry>No temporary directory was found for the file '%value%'</entry>
-                </row>
-                <row>
-                    <entry><constant>CANT_WRITE</constant></entry>
-                    <entry>The file '%value%' can't be written</entry>
-                </row>
-                <row>
-                    <entry><constant>EXTENSION</constant></entry>
-                    <entry>
-                        The extension returned an error while uploading the file '%value%'
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>ATTACK</constant></entry>
-                    <entry>The file '%value%' was illegal uploaded, possible attack</entry>
-                </row>
-                <row>
-                    <entry><constant>FILE_NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' was not found</entry>
-                </row>
-                <row>
-                    <entry><constant>UNKNOWN</constant></entry>
-                    <entry>Unknown error while uploading the file '%value%'</entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">File_WordCount</entry>
-                    <entry><constant>TOO_MUCH</constant></entry>
-                    <entry>
-                        Too much words, maximum '%max%' are allowed but '%count%' were counted
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>TOO_LESS</constant></entry>
-                    <entry>
-                        Too less words, minimum '%min%' are expected but '%count%' were counted
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>NOT_FOUND</constant></entry>
-                    <entry>The file '%value%' could not be found</entry>
-                </row>
-                <row>
-                    <entry>Float</entry>
-                    <entry><constant>NOT_FLOAT</constant></entry>
-                    <entry>'%value%' does not appear to be a float</entry>
-                </row>
-                <row>
-                    <entry>GreaterThan</entry>
-                    <entry><constant>NOT_GREATER</constant></entry>
-                    <entry>'%value%' is not greater than '%min%'</entry>
-                </row>
-                <row>
-                    <entry>Hex</entry>
-                    <entry><constant>NOT_HEX</constant></entry>
-                    <entry>'%value%' has not only hexadecimal digit characters</entry>
-                </row>
-                <row>
-                    <entry morerows="7" valign="middle">Hostname</entry>
-                    <entry><constant>IP_ADDRESS_NOT_ALLOWED</constant></entry>
-                    <entry>
-                        '%value%' appears to be an IP address, but IP addresses are not allowed
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>UNKNOWN_TLD</constant></entry>
-                    <entry>
-                        '%value%' appears to be a <acronym>DNS</acronym> hostname but cannot match <acronym>TLD</acronym> against known
-                        list
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_DASH</constant></entry>
-                    <entry>
-                        '%value%' appears to be a <acronym>DNS</acronym> hostname but contains a dash (-) in an invalid
-                        position
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_HOSTNAME_SCHEMA</constant></entry>
-                    <entry>
-                        '%value%' appears to be a <acronym>DNS</acronym> hostname but cannot match against hostname
-                        schema for <acronym>TLD</acronym> '%tld%'
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>UNDECIPHERABLE_TLD</constant></entry>
-                    <entry>
-                        '%value%' appears to be a <acronym>DNS</acronym> hostname but cannot extract <acronym>TLD</acronym> part
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_HOSTNAME</constant></entry>
-                    <entry>
-                        '%value%' does not match the expected structure for a <acronym>DNS</acronym> hostname
-                    </entry>
-                </row>
-                <row>
-                    <entry><constant>INVALID_LOCAL_NAME</constant></entry>
-                    <entry>'%value%' does not appear to be a valid local network name</entry>
-                </row>
-                <row>
-                    <entry><constant>LOCAL_NAME_NOT_ALLOWED</constant></entry>
-                    <entry>
-                        '%value%' appears to be a local network name but local network names are not
-                        allowed
-                    </entry>
-                </row>
-                <row>
-                    <entry morerows="2" valign="middle">Iban</entry>
-                    <entry><constant>NOTSUPPORTED</constant></entry>
-                    <entry>'%value%' does not have <acronym>IBAN</acronym></entry>
-                </row>
-                <row>
-                    <entry><constant>FALSEFORMAT</constant></entry>
-                    <entry>'%value%' has a false format</entry>
-                </row>
-                <row>
-                    <entry><constant>CHECKFAILED</constant></entry>
-                    <entry>'%value%' has failed the <acronym>IBAN</acronym> check</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">Identical</entry>
-                    <entry><constant>NOT_SAME</constant></entry>
-                    <entry>The token '%token%' does not match the given token '%value%'</entry>
-                </row>
-                <row>
-                    <entry><constant>MISSING_TOKEN</constant></entry>
-                    <entry>No token was provided to match against</entry>
-                </row>
-                <row>
-                    <entry>InArray</entry>
-                    <entry><constant>NOT_IN_ARRAY</constant></entry>
-                    <entry>'%value%' was not found in the haystack</entry>
-                </row>
-                <row>
-                    <entry>Int</entry>
-                    <entry><constant>NOT_INT</constant></entry>
-                    <entry>'%value%' does not appear to be an integer</entry>
-                </row>
-                <row>
-                    <entry>Ip</entry>
-                    <entry><constant>NOT_IP_ADDRESS</constant></entry>
-                    <entry>'%value%' does not appear to be a valid IP address</entry>
-                </row>
-                <row>
-                    <entry>LessThan</entry>
-                    <entry><constant>NOT_LESS</constant></entry>
-                    <entry>'%value%' is not less than '%max%'</entry>
-                </row>
-                <row>
-                    <entry>NotEmpty</entry>
-                    <entry><constant>IS_EMPTY</constant></entry>
-                    <entry>Value is required and can't be empty</entry>
-                </row>
-                <row>
-                    <entry>Regex</entry>
-                    <entry><constant>NOT_MATCH</constant></entry>
-                    <entry>'%value%' does not match against pattern '%pattern%'</entry>
-                </row>
-                <row>
-                    <entry morerows="1" valign="middle">StringLength</entry>
-                    <entry><constant>TOO_SHORT</constant></entry>
-                    <entry>'%value%' is less than %min% characters long</entry>
-                </row>
-                <row>
-                    <entry><constant>TOO_LONG</constant></entry>
-                    <entry>'%value%' is greater than %max% characters long</entry>
-                </row>
-            </tbody>
-        </tgroup>
-    </table>
+    <para>
+        These validation messages are constants which can be found at top of each validator class.
+        Let's look into <classname>Zend_Validate_GreaterThan</classname> for an descriptive example:
+    </para>
+ 
+    <programlisting language="php"><![CDATA[
+protected $_messageTemplates = array(
+    self::NOT_GREATER => "'%value%' is not greater than '%min%'",
+);
+]]></programlisting>
+
+    <para>
+        As you can see the constant <constant>self::NOT_GREATER</constant> refers to the failure and
+        is used as key, and the message itself is used as value of the message array.
+    </para>
 
     <para>
-        さらに、<methodname>getMessageTemplates()</methodname>
-        メソッドを使うとバリデータの全メッセージテンプレートを取得できます。
-        これは、検証に失敗したときにバリデータが返す可能性のあるメッセージを配列で返します。
+        You can retrieve all message templates from a validator by using the
+        <methodname>getMessageTemplates()</methodname> method. It returns you the above array which
+        contains all messages a validator could return in the case of a failed validation.
     </para>
 
     <programlisting language="php"><![CDATA[
-$validator = new Zend_Validate_Alnum();
+$validator = new Zend_Validate_GreaterThan();
 $messages  = $validator->getMessageTemplates();
 ]]></programlisting>
 
+    <para>
+        Using the <methodname>setMessage()</methodname> method you can set another message to be
+        returned in case of the specified failure.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_GreaterThan();
+$validator->setMessage('Please enter a lower value', Zend_Validate_GreaterThan::NOT_GREATER);
+]]></programlisting>
+
+    <para>
+        The second parameter defines the failure which will be overridden. When you omit this
+        parameter, then the given message will be set for all possible failures of this validator.
+    </para>
+
+    <sect2 id="zend.validate.messages.pretranslated">
+        <title>Using pre-translated validation messages</title>
+
+        <para>
+            Zend Framework is shipped with more than 45 different validators with more than 200
+            failure messages. It can be a tendious task to translate all of these messages. But for
+            your convinience Zend Framework comes with already pre-translated validation messages.
+            You can find them within the path <filename>/resources/languages</filename> in your
+            Zend Framework installation.
+        </para>
+
+        <note>
+            <title>Used path</title>
+
+            <para>
+                The resource files are outside of the library path because all of your translations
+                should also be outside of this path.
+            </para>
+        </note>
+
+        <para>
+            So to translate all validation messages to german for example, all you have to do is to
+            attach a translator to <classname>Zend_Validate</classname> using these resource files.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$translator = new Zend_Translate(
+    'array',
+    '/resources/languages',
+    $language,
+    array('scan' => Zend_Locale::LOCALE_DIRECTORY)
+);
+Zend_Validate_Abstract::setDefaultTranslator($translator);
+]]></programlisting>
+
+        <note>
+            <title>Used translation adapter</title>
+
+            <para>
+                As translation adapter Zend Framework choosed the array adapter. It is simple to
+                edit and created very fast.
+            </para>
+        </note>
+
+        <note>
+            <title>Supported languages</title>
+
+            <para>
+                This feature is very young, so the amount of supported languages may not be
+                complete. New languages will be added with each release. Additionally feel free to
+                use the existing resource files to make your own translations.
+            </para>
+
+            <para>
+                You could also use these resource files to rewrite existing translations. So you
+                are not in need to create these files manually yourself.
+            </para>
+        </note>
+    </sect2>
+
     <sect2 id="zend.validate.messages.limitation">
         <title>検証メッセージのサイズの制限</title>
 
@@ -606,9 +146,11 @@ Zend_Validate::setMessageLength(100);
 ]]></programlisting>
 
         <note>
+            <!-- TODO : to be translated -->
+            <title>Where is this parameter used?</title>
             <para>
-                ここで設定したメッセージ長はすべてのバリデータに適用されることに注意しましょう。
-                自前で定義したバリデータに関しても、それが <classname>Zend_Validate_Abstract</classname>
+                ここで設定したメッセージ長はすべてのバリデータで使われます。
+                自前で定義したバリデータでさえも、それが <classname>Zend_Validate_Abstract</classname>
                 を継承したものである限りは同じです。
             </para>
         </note>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19425 -->
+<!-- EN-Revision: 20227 -->
 <sect1 id="zend.view.helpers" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>ビューヘルパー</title>
 
@@ -45,11 +45,11 @@
 
     <para>
         ビュースクリプト内でヘルパーを使用するには、
-        <code>$this->helperName()</code> をコールします。これをコールすると、裏側では
+        <command>$this->helperName()</command> をコールします。これをコールすると、裏側では
         <classname>Zend_View</classname> が <classname>Zend_View_Helper_HelperName</classname> クラスを読み込み、
         そのクラスのインスタンスを作成して <methodname>helperName()</methodname> メソッドをコールします。
         オブジェクトのインスタンスは <classname>Zend_View</classname> インスタンスの中に残り続け、
-        後で <code>$this->helperName()</code> がコールされたときには再利用されます。
+        後で <command>$this->helperName()</command> がコールされたときには再利用されます。
     </para>
 
     <sect2 id="zend.view.helpers.initial">
@@ -67,7 +67,7 @@
         <itemizedlist>
 
             <listitem><para>
-                <code>declareVars():</code>
+                <methodname>declareVars():</methodname>
                 <methodname>strictVars()</methodname> を使用する際に同時に使用します。
                 このヘルパーを使用すると、テンプレート変数を宣言できます。
                 この変数は、すでにビュースクリプトで設定されているものでもいないものでもかまいません。
@@ -77,7 +77,7 @@
             </para></listitem>
 
             <listitem><para>
-                <code>fieldset($name, $content, $attribs):</code>
+                <methodname>fieldset($name, $content, $attribs):</methodname>
                 <acronym>XHTML</acronym> の fieldset を作成します。<varname>$attribs</varname> に
                 'legend' というキーが含まれる場合、その値をフィールドセットの説明として使用します。
                 フィールドセットで囲む内容は、このヘルパーに渡した
@@ -85,23 +85,23 @@
             </para></listitem>
 
             <listitem><para>
-                <code>form($name, $attribs, $content):</code>
+                <methodname>form($name, $attribs, $content):</methodname>
                 <acronym>XHTML</acronym> の form を作成します。すべての <varname>$attribs</varname>
                 はエスケープされ、form タグの <acronym>XHTML</acronym> 属性としてレンダリングされます。
-                <varname>$content</varname> が存在してその値が false 以外の場合は、
+                <varname>$content</varname> が存在してその値が <constant>FALSE</constant> 以外の場合は、
                 その内容がフォームの開始タグと終了タグの間にレンダリングされます。
-                <varname>$content</varname> が false (デフォルト) の場合は、
+                <varname>$content</varname> が <constant>FALSE</constant> (既定値) の場合は、
                 フォームの開始タグのみを作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formButton($name, $value, $attribs):</code> &lt;button /&gt; 要素を作成します。
+                <methodname>formButton($name, $value, $attribs):</methodname> &lt;button /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem>
                 <para>
-                    <code>formCheckbox($name, $value, $attribs,
-                        $options):</code>
+                    <methodname>formCheckbox($name, $value, $attribs,
+                        $options):</methodname>
                     &lt;input type="checkbox" /&gt; 要素を作成します。
                 </para>
 
@@ -179,7 +179,7 @@ echo $this->formCheckbox('foo',
 
             <listitem>
                 <para>
-                    <code>formErrors($errors, $options):</code>
+                    <methodname>formErrors($errors, $options):</methodname>
                     エラーの表示用に、<acronym>XHTML</acronym> の順序なしリストを作成します。
                     <varname>$errors</varname> は、文字列あるいは文字列の配列となります。
                     <varname>$options</varname> は、リストの開始タグの属性として設定したい内容です。
@@ -212,27 +212,27 @@ echo $this->formCheckbox('foo',
             </listitem>
 
             <listitem><para>
-                <code>formFile($name, $attribs):</code>
+                <methodname>formFile($name, $attribs):</methodname>
                 type="file" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formHidden($name, $value, $attribs):</code> &lt;input
+                <methodname>formHidden($name, $value, $attribs):</methodname> &lt;input
                 type="hidden" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formLabel($name, $value, $attribs):</code>
-                &lt;label&gt; 要素を作成します。<code>for</code> 属性の値は
+                <methodname>formLabel($name, $value, $attribs):</methodname>
+                &lt;label&gt; 要素を作成します。<property>for</property> 属性の値は
                 <varname>$name</varname> に、そしてラベルのテキストは
                 <varname>$value</varname> になります。
-                <varname>attribs</varname> に <code>disable</code>
+                <property>attribs</property> に <emphasis>disable</emphasis>
                 を渡すと、結果を何も返しません。
             </para></listitem>
 
             <listitem><para>
-                <code>formMultiCheckbox($name, $value, $attribs, $options,
-                    $listsep):</code> チェックボックスのリストを作成します。
+                <methodname>formMultiCheckbox($name, $value, $attribs, $options,
+                    $listsep):</methodname> チェックボックスのリストを作成します。
                 <varname>$options</varname> は連想配列で、任意の深さにできます。
                 <varname>$value</varname> は単一の値か複数の値の配列で、これが
                 <varname>$options</varname> 配列のキーにマッチします。
@@ -244,12 +244,12 @@ echo $this->formCheckbox('foo',
             </para></listitem>
 
             <listitem><para>
-                <code>formPassword($name, $value, $attribs):</code> &lt;input
+                <methodname>formPassword($name, $value, $attribs):</methodname> &lt;input
                 type="password" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formRadio($name, $value, $attribs, $options):</code>
+                <methodname>formRadio($name, $value, $attribs, $options):</methodname>
                 一連の &lt;input type="radio" /&gt; 要素を、
                 $options の要素ごとに作成します。$options は、
                 ラジオボタンの値をキー、ラベルを値とする配列となります。
@@ -257,12 +257,12 @@ echo $this->formCheckbox('foo',
             </para></listitem>
 
             <listitem><para>
-                <code>formReset($name, $value, $attribs):</code> &lt;input
+                <methodname>formReset($name, $value, $attribs):</methodname> &lt;input
                 type="reset" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formSelect($name, $value, $attribs, $options):</code>
+                <methodname>formSelect($name, $value, $attribs, $options):</methodname>
                 &lt;select&gt;...&lt;/select&gt; ブロックを作成します。
                 $options の要素ごとに &lt;option&gt; を作成します。
                 $options は、選択肢の値をキー、
@@ -271,35 +271,35 @@ echo $this->formCheckbox('foo',
             </para></listitem>
 
             <listitem><para>
-                <code>formSubmit($name, $value, $attribs):</code> &lt;input
+                <methodname>formSubmit($name, $value, $attribs):</methodname> &lt;input
                 type="submit" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formText($name, $value, $attribs):</code> &lt;input
+                <methodname>formText($name, $value, $attribs):</methodname> &lt;input
                 type="text" /&gt; 要素を作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>formTextarea($name, $value, $attribs):</code>
+                <methodname>formTextarea($name, $value, $attribs):</methodname>
                 &lt;textarea&gt;...&lt;/textarea&gt; ブロックを作成します。
             </para></listitem>
 
             <listitem><para>
-                <code>url($urlOptions, $name, $reset):</code>
+                <methodname>url($urlOptions, $name, $reset):</methodname>
                 指定したルートにもとづく <acronym>URL</acronym> 文字列を作成します。
                 <varname>$urlOptions</varname> は、そのルートで使用する
                 キー/値 のペアの配列となります。
             </para></listitem>
 
             <listitem><para>
-                <code>htmlList($items, $ordered, $attribs, $escape):</code>
+                <methodname>htmlList($items, $ordered, $attribs, $escape):</methodname>
                 <varname>$items</varname> で渡した内容をもとに
                 順序つきリストあるいは順序なしリストを作成します。
                 <varname>$items</varname> が多次元配列の場合は、入れ子状のリストとなります。
-                <varname>$escape</varname> フラグを true (デフォルト) にすると、
+                <varname>$escape</varname> フラグを <constant>TRUE</constant> (既定値) にすると、
                 各項目はビューオブジェクトに登録されているエスケープ方式でエスケープされます。
-                リスト内でマークアップを行いたい場合は false を渡します。
+                リスト内でマークアップを行いたい場合は <constant>FALSE</constant> を渡します。
             </para></listitem>
 
         </itemizedlist>
@@ -355,6 +355,9 @@ echo $this->formCheckbox('foo',
 
         <xi:include href="Zend_View-Helpers-Action.xml" />
         <xi:include href="Zend_View-Helpers-BaseUrl.xml" />
+        <xi:include href="Zend_View-Helpers-Currency.xml">
+            <xi:fallback><xi:include href="../../en/module_specs/Zend_View-Helpers-Currency.xml" /></xi:fallback>
+        </xi:include>
         <xi:include href="Zend_View-Helpers-Cycle.xml" />
         <xi:include href="Zend_View-Helpers-Partial.xml" />
         <xi:include href="Zend_View-Helpers-Placeholder.xml" />
@@ -481,7 +484,7 @@ $view->addHelperPath('/other/path/to/helpers', 'Your_View_Helper');
         </para>
 
         <para>
-            <code>SpecialPurpose</code> ヘルパーのコードの例を示します。
+            <classname>SpecialPurpose</classname> ヘルパーのコードの例を示します。
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -498,7 +501,7 @@ class My_View_Helper_SpecialPurpose extends Zend_View_Helper_Abstract
 ]]></programlisting>
 
         <para>
-            そして、ビュースクリプト内で <code>SpecialPurpose</code>
+            そして、ビュースクリプト内で <classname>SpecialPurpose</classname>
             ヘルパーを必要なだけコールします。いちどインスタンスが作成された後は、
             <classname>Zend_View</classname> インスタンスの中でそれが持続します。
         </para>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18833 -->
+<!-- EN-Revision: 20115 -->
 <sect1 id="migration.17">
     <title>Zend Framework 1.7</title>
 
@@ -62,11 +62,13 @@
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Filter_File_Rename($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Filter_File_Rename($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>source</emphasis> (<varname>$oldfile</varname> と同等)、
                         <emphasis>target</emphasis> (<varname>$newfile</varname> と同等)、
@@ -98,11 +100,13 @@ $upload->addFilter('Rename',
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_Count($min, $max)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Count($min, $max)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_Count($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Count($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>min</emphasis> (<varname>$min</varname> と同等)、
                         <emphasis>max</emphasis> (<varname>$max</varname> と同等)
@@ -133,11 +137,13 @@ $upload->addValidator('Count',
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_Extension($extension, $case)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Extension($extension, $case)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_Extension($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Extension($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>*</emphasis> (<varname>$extension</varname> と同等、任意の他のキーを使用可能)、
                         <emphasis>case</emphasis> (<varname>$case</varname> と同等)
@@ -168,11 +174,13 @@ $upload->addValidator('Extension',
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_FilesSize($min, $max, $bytestring)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_FilesSize($min, $max, $bytestring)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_FilesSize($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_FilesSize($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>min</emphasis> (<varname>$min</varname> と同等)、
                         <emphasis>max</emphasis> (<varname>$max</varname> と同等)、
@@ -219,11 +227,13 @@ $upload->setUseByteSting(true); // set flag
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_Hash($hash, $algorithm)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Hash($hash, $algorithm)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_Hash($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Hash($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>*</emphasis> (<varname>$hash</varname> と同等、任意の他のキーを使用可能)、
                         <emphasis>algorithm</emphasis> (<varname>$algorithm</varname> と同等)、
@@ -254,11 +264,13 @@ $upload->addValidator('Hash',
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth, $maxheight)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth, $maxheight)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_FilesSize($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_FilesSize($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>minwidth</emphasis> (<varname>$minwidth</varname> と同等)、
                         <emphasis>maxwidth</emphasis> (<varname>$maxwidth</varname> と同等)、
@@ -293,11 +305,13 @@ $upload->addValidator('ImageSize',
 
                 <itemizedlist>
                     <listitem><para>
-                        古い形式の <acronym>API</acronym>: <command>Zend_Validate_File_Size($min, $max, $bytestring)</command>
+                        古い形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Size($min, $max, $bytestring)</methodname>
                     </para></listitem>
 
                     <listitem><para>
-                        新しい形式の <acronym>API</acronym>: <command>Zend_Validate_File_Size($options)</command>
+                        新しい形式の <acronym>API</acronym>:
+                        <methodname>Zend_Validate_File_Size($options)</methodname>
                         <varname>$options</varname> には次の配列キーを使えます。
                         <emphasis>min</emphasis> (<varname>$min</varname> と同等)、
                         <emphasis>max</emphasis> (<varname>$max</varname> と同等)、
@@ -340,7 +354,7 @@ $upload->addValidator('Size',
                 リリース 1.7 では、互換性モードが追加されて文字列を返す古い挙動も使えます。
                 しかし、このばあいは新しい挙動に変更するようにというユーザ警告が発生します。
                 古い挙動の <methodname>isLocale()</methodname> が行っていた再ルーティングはもはや不要で、
-                すべての I18N は自分自身で再ルーティングを行います。
+                すべての I18n は自分自身で再ルーティングを行います。
             </para>
 
             <para>
@@ -437,7 +451,7 @@ $locale = Zend_Locale::getOrder(Zend_Locale::BROWSER);
                 <para>
                     デフォルトでは古い挙動も有効ですが、ユーザ警告が発生します。
                     新しい挙動にあわせてコードを変更し終えたら、
-                    互換性モードを false に変更して警告が発生しないようにしなければなりません。
+                    互換性モードを <constant>FALSE</constant> に変更して警告が発生しないようにしなければなりません。
                 </para>
             </note>
         </sect3>
@@ -471,7 +485,7 @@ $locale = Zend_Locale::getOrder(Zend_Locale::BROWSER);
 
             <para>
                 これらの notice を発生させないようにするためには、新たなオプション
-                'disableNotices' を true に設定するだけです。デフォルトは false となっています。
+                'disableNotices' を <constant>TRUE</constant> に設定するだけです。デフォルトは <constant>FALSE</constant> となっています。
             </para>
 
             <example id="migration.17.zend.translate.example">
@@ -509,7 +523,7 @@ $language = new Zend_Translate('gettext',
 
         <note>
             <para>
-                <classname>Zend_View</classname> 内の API 変更は、
+                <classname>Zend_View</classname> 内の <acronym>API</acronym> 変更は、
                 リリース 1.7.5 またはそれ以降にアップグレードする際にだけ注意すべきです。
             </para>
         </note>
@@ -517,12 +531,12 @@ $language = new Zend_Translate('gettext',
         <para>
             Zend Framework 開発陣は、1.7.5 より前のバージョンにおいて
             <methodname>Zend_View::render()</methodname> メソッドにローカルファイル読み込み
-            (Local File Inclusion: LFI) 脆弱性の問題があることに気づきました。
+            (Local File Inclusion: <acronym>LFI</acronym>) 脆弱性の問題があることに気づきました。
             1.7.5 より前のバージョンでは、このメソッドはデフォルトで
             親ディレクトリを指す記法 ("../" や "..\")
             を含むビュースクリプトも指定できてしまいます。
             フィルタリングをしていないユーザ入力が <methodname>render()</methodname>
-            メソッドに渡されると、LFI 攻撃を受ける可能性が出てきます。
+            メソッドに渡されると、 <acronym>LFI</acronym> 攻撃を受ける可能性が出てきます。
         </para>
 
         <programlisting language="php"><![CDATA[