[DOCUMENT]sync en

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24827 -->
 <sect1 id="zend.controller.front">
     <title>フロントコントローラ</title>
 
@@ -324,6 +324,20 @@ Zend_Controller_Front::run('../application/controllers');
                     を指定したり、現在の値を取得したりします。
                     この値は、ルーティングの直前にリクエストオブジェクトに渡されます。
                 </para>
+
+                <!-- TODO : to be translated -->
+                <note>
+                    <title>Fully-Qualified URL is not supported</title>
+                    <para>
+                        Passing a fully-qualified URL (ie: http://example.com/) to the
+                        <methodname>setBaseUrl</methodname> method is not supported, and 
+                        will cause issues when using the URL view helper. See ticket 
+                        <ulink url="http://framework.zend.com/issues/browse/ZF-10923">
+                            ZF-10923
+                        </ulink> for more details.
+                    </para>
+                </note>
+
             </listitem>
 
             <listitem>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24827 -->
 <sect1 id="zend.controller.request">
     <title>リクエストオブジェクト</title>
     <sect2 id="zend.controller.request.introduction">
@@ -254,6 +254,20 @@ $controller->setControllerDirectory('./application/controllers')
 $response   = $controller->dispatch();
 ]]></programlisting>
 
+            <!-- TODO : to be translated -->
+            <note>
+                <title>Fully-Qualified URL is not supported</title>
+                <para>
+                    Passing a fully-qualified URL (ie: http://example.com/) to the
+                    <methodname>setBaseUrl</methodname> method is not supported, and 
+                    will cause issues for both the usage describe above and when using
+                    the URL view helper. See ticket 
+                    <ulink url="http://framework.zend.com/issues/browse/ZF-10923">
+                        ZF-10923
+                    </ulink> for more details.
+                </para>
+            </note>
+
         </sect3>
 
         <sect3 id="zend.controller.request.http.method">

documentation/manual/ja/module_specs/Zend_Db_Table-Relationships.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24820 -->
+<!-- EN-Revision: 24831 -->
 <sect1 id="zend.db.table.relationships">
     <title>導入</title>
     <!-- Skip-EN-Revisions: 21587 -->
@@ -835,14 +835,37 @@ $product1234->delete();
 
         <para>
             <classname>Zend_Db_Table</classname> で連鎖リレーションを宣言するには、
-            <varname>$_referenceMap</varname> の中でのルールを編集し、
-            連想配列のキー <code>'onDelete'</code> および
-            <code>'onUpdate'</code> に文字列 'cascade'
-            (あるいは定数 <constant>self::CASCADE</constant>)
-            を設定します。
-            親テーブルから行が削除されたり主キーの値が更新されたりする前に、
-            その行を参照している従属テーブルの行が
-            まず削除あるいは更新されます。
+            <varname>$_referenceMap</varname> の中でのルールを編集します。
+             連想配列のキー <command>'onDelete'</command> および <command>'onUpdate'</command>
+              をそれらのオプションの一つに設定します。
+        </para>
+
+        <!-- TODO : to be translated -->
+        <itemizedlist>
+
+            <listitem>
+                <para>
+                    Cascade:  This option configures a single-level cascade (parent table plus all
+                    directly-dependent tables).  To enable this option set the appropriate key in
+                    <varname>$_referenceMap</varname> to string 'cascade' or use the constant 
+                    <constant>self::CASCADE</constant>. 
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Recursive Cascade:  This option configures a full recursive cascade starting
+                    with the parent table.  To enable this option set the appropriate key in
+                    <varname>$_referenceMap</varname> to string 'cascadeRecurse' or use the constant 
+                    <constant>self::CASCADE_RECURSE</constant>. 
+                </para>
+            </listitem>
+
+        </itemizedlist>
+
+        <para>
+            親テーブルから行が削除されたり、主キーの値が更新されたりする前に、
+            その親の行を参照する従属テーブルの行が最初に削除あるいは更新されます。
         </para>
 
         <example id="zend.db.table.relationships.cascading.example-declaration">

documentation/manual/ja/module_specs/Zend_Form-StandardDecorators.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24852 -->
 <sect1 id="zend.form.standardDecorators">
     <title>Zend Framework に同梱されている標準のデコレータ</title>
     <!-- Skip-EN-Revisions: 21995 -->
@@ -91,7 +91,7 @@ class Util
             を渡すか、あるいは <methodname>setTag()</methodname> をコールします。
             さらに、そのタグにクラスを指定することもできます。これは、オプション
             <code>class</code> あるいはメソッド
-            <methodname>setClass()</methodname> で指定します。
+            <methodname>setOption('class', 'foo')</methodname> で指定します。
             デフォルトで使用するクラスは 'hint' です。
         </para>
 
@@ -375,9 +375,40 @@ class Util
 
         <para>
             デフォルトでは、Label デコレータは元のコンテンツの先頭に結果を追加します。
-            'placement' オプションを 'append' にすると、
-            コンテンツの末尾に追加できます。
+            これは、下記の 'placement' オプションのうちの一つを指定することによってコントロールできます。
         </para>
+
+        <!-- TODO : to be translated -->
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <property>PREPEND</property>: render the label before the
+                    content.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <property>APPEND</property>: render the label after the
+                    content.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <property>IMPLICIT_PREPEND</property>: render the element
+                    inside the label tag, placing the label text before the content.
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <property>IMPLICIT_APPEND</property>: render the element
+                    inside the label tag, placing the label text after the content.
+                </para>
+            </listitem>
+        </itemizedlist>
+
     </sect2>
 
     <sect2 id="zend.form.standardDecorators.prepareElements">
@@ -402,6 +433,17 @@ $form->setDecorators(array(
 ]]></programlisting>
     </sect2>
 
+    <sect2 id="zend.form.standardDecorators.tooltip">
+        <title>Zend_Form_Decorator_Tooltip</title>
+
+        <!-- TODO : to be translated -->
+        <para>
+            The Tooltip decorator translates the title attribute if it is
+            available, if the translator is available and if the translator is
+            not disable on the element being rendered.
+        </para>
+    </sect2>
+
     <sect2 id="zend.form.standardDecorators.viewHelper">
         <title>Zend_Form_Decorator_ViewHelper</title>
 

documentation/manual/ja/module_specs/Zend_Form-StandardElements.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24757 -->
+<!-- EN-Revision: 24835 -->
 <sect1 id="zend.form.standardElements">
     <title>Zend Framework に同梱されている標準のフォーム要素</title>
 

documentation/manual/ja/module_specs/Zend_Http_Cookie-Handling.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24856 -->
 <sect1 id="zend.http.cookies">
     <title>Zend_Http_Cookie および Zend_Http_CookieJar</title>
 
@@ -445,6 +445,16 @@ $cookie->match('http://www.example.com/', true, time() + (3 * 3600));
                     "Cookie" で送信したい場合に非常に便利です。
                     </para>
                 </listitem>
+
+                <!-- TODO : to be translated -->
+                <listitem>
+                    <para>
+                        <constant>Zend_Http_CookieJar::COOKIE_STRING_CONCAT_STRICT</constant>: Similar to
+                        COOKIE_STRING_CONCAT, but follows a strict implementation of RFC6265.  In this mode,
+                        a single space character always follows the semicolon separator between cookies, and 
+                        the semicolon separator is stripped from the end of the cookie string.
+                    </para>
+                </listitem>
             </itemizedlist>
         </para>
         <para>

documentation/manual/ja/module_specs/Zend_Service.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24837 -->
 <sect1 id="zend.service.introduction">
     <title>導入</title>
     <para>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24845 -->
 <sect1 id="zend.validate.writing_validators">
 
     <title>バリデータの書き方</title>
@@ -74,7 +74,7 @@ class MyValid_Float extends Zend_Validate_Abstract
         $this->_setValue($value);
 
         if (!is_float($value)) {
-            $this->_error();
+            $this->_error(self::FLOAT);
             return false;
         }
 
@@ -89,8 +89,6 @@ class MyValid_Float extends Zend_Validate_Abstract
             <methodname>_setValue()</methodname> のコールによって、検証した値をこのメッセージに自動的に格納します。
             これにより、検証に失敗したときに、この値をメッセージに含められるようになります。
             <methodname>_error()</methodname> のコールによって、検証に失敗した原因を取得します。
-            このクラスでは失敗時のメッセージをひとつしか用意していないので、
-            <methodname>_error()</methodname> でメッセージテンプレートの名前を指定する必要はありません。
         </para>
 
     </example>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 24249 -->
+<!-- EN-Revision: 24829 -->
 <sect3 id="zend.view.helpers.initial.json">
     <title>JSON ヘルパー</title>
 
@@ -74,6 +74,31 @@ echo $this->json($this->data, array('keepLayouts' => true));
 )) ?>
 ]]></programlisting>
     </note>
+
+    <!-- TODO : to be translated -->
+    <note>
+        <title>Sending pre-encoded JSON</title>
+
+        <para>
+            By default, the <acronym>JSON</acronym> helper will JSON-encode the 
+            data provided to the helper's first parameter.  If you wish to pass 
+            in data which has already been encoded into <acronym>JSON</acronym>, 
+            the third parameter needs to be set to boolean <constant>FALSE</constant>.  
+            When the second parameter is an array, disabling <acronym>JSON</acronym> 
+            encoding can be achived by including a <property>encodeData</property> 
+            key with the value of boolean <constant>FALSE</constant>:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+// Boolean false as third argument disables internal JSON encoding of data
+echo $this->json($this->data, false, false);
+
+// Or boolean false as "encodeData" key:
+echo $this->json($this->data, array('encodeData' => false));
+]]></programlisting>
+
+    </note>
+
 </sect3>
 <!--
 vim:se ts=4 sw=4 et: