[DOCUMENTATION] add TODO tags and one new doc

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

documentation/manual/ja/module_specs/Zend_Application-AvailableResources-Dojo.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 21357 -->
+<sect2 id="zend.application.available-resources.dojo">
+    <title>Zend_Application_Resource_Dojo(日本語)</title>
+
+    <para>
+        <classname>Zend_Application_Resource_Dojo</classname>は、
+        <classname>Zend_Dojo</classname> viewhelper を設定するために使用できます。
+    </para>
+
+    <example id="zend.application.available-resources.dojo.configExample">
+        <title>Dojo リソース設定例</title>
+
+        <para>
+            下記は、<classname>Zend_Dojo</classname> を利用可能にする方法を示す、
+            <acronym>INI</acronym> ファイル例です。
+        </para>
+
+        <programlisting language="ini"><![CDATA[
+resources.dojo.enable = true ; Always load the Dojo javascript files
+]]></programlisting>
+
+        <!-- TODO : to be translated -->
+        <para>
+            The <classname>Zend_Dojo</classname> resource plugin utilises the options for the
+            <methodname>Zend_Dojo_View_Helper_Dojo_Container::setOptions()</methodname> to
+            configure the viewhelpers. Please see the <link linkend="zend.dojo">Zend_Dojo</link>
+            chapter for full descriptions and available options.
+        </para>
+    </example>
+</sect2>

documentation/manual/ja/module_specs/Zend_Application-AvailableResources-View.xml

@@ -19,10 +19,10 @@
     </para>
 
     <example id="zend.application.available-resources.view.configExample">
-        <title>サンプルビューリソースの設定</title>
+        <title>ビューリソースの設定例</title>
 
         <para>
-            下記はビューリソースを設定する方法を示す <acronym>INI</acronym> スニペットサンプルです。
+            下記はビューリソースを設定する方法を示す <acronym>INI</acronym> スニペット例です。
         </para>
 
         <programlisting language="ini"><![CDATA[
@@ -32,19 +32,19 @@ resources.view.basePath = APPLICATION_PATH "/views/"
     </example>
 
     <sect3 id="zend.application.available-resources.view.doctype">
-         <title>Defining doctype to use</title>
+         <title>使用する doctype を定義</title>
 
          <para>
-             If you want to obtain more information about values, see <link 
-             linkend="zend.view.helpers.initial.doctype">Doctype Helper 
-             </link>.
+             値について詳しくは、<link 
+             linkend="zend.view.helpers.initial.doctype">Doctype Helper</link>
+             をご覧ください。
          </para>
  
          <example id="zend.application.available-resources.view.doctypeExample">
-             <title>Sample doctype configuration</title>
+             <title>doctype 設定例</title>
 
              <para>
-                 The following snippet shows how to set a doctype.
+                 下記のスニペットは、doctype を設定する方法を示します。
              </para>
 
              <programlisting language="ini"><![CDATA[
@@ -54,19 +54,19 @@ resources.view.doctype = "HTML5"
      </sect3>
 
      <sect3 id="zend.application.available-resources.view.contentType">
-        <title>Defining content type and encoding to use</title>
+         <title>使用するコンテンツタイプとエンコーディングを定義</title>
 
          <para>
-             If you want to obtain more information about values, see <link 
-             linkend="zend.view.helpers.initial.headmeta">HeadMeta Helper
-             </link>.
+             値について詳しくは、<link 
+             linkend="zend.view.helpers.initial.headmeta">HeadMeta Helper</link>
+             をご覧ください。
          </para>
 
          <example id="zend.application.available-resources.view.contentTypeExample">
-             <title>Sample content type and encoding configuration</title>
+             <title>コンテンツタイプとエンコーディングの設定例</title>
 
              <para>
-                 The following snippet shows how to set a meta Content-Type.
+                 下記のスニペットは、メタ Content-Type を設定する方法を示します。
              </para>
 
             <programlisting language="ini"><![CDATA[
@@ -75,10 +75,10 @@ resources.view.contentType = "text/html; charset=UTF-8"
          </example>
 
         <example id="zend.application.available-resources.view.charsetExample">
-            <title>Sample encoding configuration for a HTML5 document</title>
+            <title>HTML5 ドキュメント用のエンコーディング設定例</title>
 
             <para>
-                The following snippet shows how to set a meta charset in HTML5-style.
+                下記のスニペットは、メタ charset を HTML5 スタイルで設定する方法を示します。
             </para>
 
             <programlisting language="ini"><![CDATA[

documentation/manual/ja/module_specs/Zend_Application-CoreFunctionality-Resource_ResourceAbstract.xml

@@ -187,7 +187,6 @@ class My_Resource_View extends Zend_Application_Resource_ResourceAbstract
 ]]></programlisting>
 
         <para>
-            We can then bootstrap that resource or retrieve it by the name
             その場合、そのリソースを起動するか、または名前 "<classname>My_View</classname>" によって
             取得できます:
         </para>

documentation/manual/ja/module_specs/Zend_Application-Examples.xml

@@ -32,6 +32,7 @@ resources.frontController.controllerDirectory = APPLICATION_PATH "/controllers"
 [development : production]
 ]]></programlisting>
 
+    <!-- TODO : to be translated -->
     <note>
         <title>Autoloader namespaces</title>
 

documentation/manual/ja/module_specs/Zend_Config_Writer.xml

@@ -181,6 +181,7 @@ $writer->write();
     <sect2 id="zend.config.writer.introduction.yaml-notes">
         <title>YAML ライター特有の注意</title>
 
+        <!-- TODO : to be translated -->
         <para>
             The <acronym>YAML</acronym> writer lets you optionally specify an alternate
             <acronym>YAML</acronym> encoder to use. By default, one is shipped with the framework

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

@@ -311,7 +311,7 @@ if ($this->_hasParam('id') {
         <title>ビューの統合</title>
 
         <note id="zend.controller.action.viewintegration.viewrenderer">
-            <title>Default view integration is via the ViewRenderer</title>
+            <title>デフォルトのビュー統合は ViewRenderer を介します</title>
 
             <para>
                 この節の内容は、

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

@@ -1391,6 +1391,7 @@ print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");
                         <entry>a</entry>
                         <entry>午前/午後 (地域化された形式)</entry>
                         <entry><constant>Zend_Date::MERIDIEM</constant></entry>
+                        <!-- TODO : to be translated -->
                         <entry>a (sort of, but likely to be uppercase)</entry>
                         <entry><emphasis>vorm.</emphasis>
                         </entry>
@@ -1399,6 +1400,7 @@ print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");
                         <entry>A</entry>
                         <entry>午前/午後 (地域化された形式)</entry>
                         <entry><constant>Zend_Date::MERIDIEM</constant></entry>
+                        <!-- TODO : to be translated -->
                         <entry>a (sort of, but no guarantee that the format is uppercase)</entry>
                         <entry><emphasis>VORM.</emphasis>
                         </entry>

documentation/manual/ja/module_specs/Zend_Dojo-View-Dojo.xml

@@ -112,8 +112,9 @@ $this->dojo()->enable()
     </example>
 
     <note>
-        <title>UTF-8 encoding used by default</title>
+        <title>デフォルトで使用される UTF-8 エンコーディング</title>
 
+        <!-- TODO : to be translated -->
         <para>
             By default, Zend Framework uses <acronym>UTF-8</acronym> as its default encoding, and,
             specific to this case, <classname>Zend_View</classname> does as well. Character encoding

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

@@ -37,7 +37,7 @@
         <title>基本的な使用法</title>
 
         <para>
-            The usage of this filter is quite simple.
+            このフィルタの使い方はとても簡単です。
             文字列を逆にするフィルタを生成したいとしましょう。
         </para>
 

documentation/manual/ja/module_specs/Zend_Filter.xml

@@ -185,6 +185,7 @@ echo Zend_Filter::filterStatic('"', 'OtherFilter', array($parameters));
         </sect3>
     </sect2>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.filter.introduction.caveats">
         <title>Double filtering</title>
 

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

@@ -590,6 +590,7 @@ $messages = $element->getMessages();
             バリデータに加えて、ある要素が必須である場合は
             <methodname>setRequired($flag)</methodname> を使用できます。
             デフォルトではこのフラグは <constant>FALSE</constant> です。
+            <!-- TODO : to be translated -->
             In combination with
             <methodname>setAllowEmpty($flag)</methodname> (<constant>TRUE</constant>
             by default) and <methodname>setAutoInsertNotEmptyValidator($flag)</methodname>
@@ -655,6 +656,7 @@ $messages = $element->getMessages();
             </para>
         </note>
 
+        <!-- TODO : to be translated -->
         <note>
             <title>When is an element detected as empty?</title>
 
@@ -779,7 +781,7 @@ $messages = $element->getMessages();
                 </para></listitem>
 
                 <listitem><para>
-                    <code>addError($message)</code>: add a message to the custom
+                    <code>addError($message)</code>:
                     エラーメッセージをカスタムエラーメッセージスタックに追加し、
                     要素を無効とマークします。
                 </para></listitem>

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

@@ -492,6 +492,7 @@ if (!$form->isValid($_POST)) {
             20 文字までの間であることとし、
             入力された内容はすべて小文字に変換することにします。
             パスワードは 6 文字以上でなければならないようにします。
+            <!-- TODO : to be translated -->
             We'll simply toss the submit value when done,
             so it can remain unvalidated.
         </para>
@@ -591,6 +592,7 @@ class UserController extends Zend_Controller_Action
             オブジェクトを渡すか、あるいは <methodname>setConfig()</methodname>
             を使用して渡すことになります。先ほどのようなフォームを
             <acronym>INI</acronym> ファイルを用いて作成できないかどうかを検討してみましょう。
+            <!-- TODO : to be translated -->
             First, let's follow the
             recommendations, and place our configurations into sections
             reflecting the release location, and focus on the 'development'

documentation/manual/ja/module_specs/Zend_Gdata_Gapps.xml

@@ -590,6 +590,7 @@ $gdata->deleteNickname('bar');
 
     </sect2>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.gdata.gapps.groups">
         <title>Interacting with groups</title>
 

documentation/manual/ja/module_specs/Zend_Json-Basics.xml

@@ -17,6 +17,7 @@ $phpNative = Zend_Json::decode($encodedValue);
 $json = Zend_Json::encode($phpNative);
 ]]></programlisting>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.json.basics.prettyprint">
         <title>Pretty-printing JSON</title>
 
@@ -36,6 +37,7 @@ if($debug) {
 }
 ]]></programlisting>
 
+        <!-- TODO : to be translated -->
         <para>
             Second optional argument of <methodname>Zend_Json::prettyPrint()</methodname> is an option array.
             Option <property>indent</property> allows to set indentation string - by default it's a single tab character.

documentation/manual/ja/module_specs/Zend_Loader.xml

@@ -115,6 +115,7 @@ Zend_Loader::loadClass('Container_Tree',
             英数字とハイフン ('-')、アンダースコア ('_') そしてピリオド ('.') だけです。
         </para>
 
+        <!-- TODO : to be translated -->
         <note>
             <title>Loading Classes from PHP Namespaces</title>
 

documentation/manual/ja/module_specs/Zend_Markup-Renderers.xml

@@ -49,6 +49,7 @@ echo $bbcode->render('my [foo]markup[/foo]');
             Textile はカスタムマークアップをサポートしません。
         </para>
 
+        <!-- TODO : to be translated -->
         <para>
             Some renderers (like the <acronym>HTML</acronym> renderer) also have support for a
             'markup' parameter. This replaces the 'start' and 'end' parameters, and

documentation/manual/ja/module_specs/Zend_Service_Amazon.xml

@@ -594,6 +594,7 @@ foreach ($results as $result) {
                             <row>
                                 <entry>MerchantName</entry>
                                 <entry>string</entry>
+                                <!-- TODO : to be translated -->
                                 <entry>Merchants Amazon Name.  Requires setting the <code>ResponseGroup</code> option to <code>OfferFull</code> to retrieve.</entry>
                             </row>
                             <row>

documentation/manual/ja/module_specs/Zend_Service_Nirvanix.xml

@@ -360,7 +360,7 @@ try {
             上の例で使用している <methodname>unlink()</methodname> は、REST <acronym>API</acronym> の
             <code>DeleteFiles</code> コマンドをラップした便利なメソッドです。
             <ulink url="http://developer.nirvanix.com/sitefiles/1000/API.html#_Toc175999918">DeleteFiles</ulink>
-            コマンドが要求する The <code>filePath</code> パラメータに、
+            コマンドが要求する<code>filePath</code> パラメータに、
             存在しないパスを指定しています。その結果、
             <classname>Zend_Service_Nirvanix</classname> からは例外がスローされます。
             メッセージは "Invalid path"、そしてコードは 70005 となります。

documentation/manual/ja/module_specs/Zend_Session-GlobalSessionManagement.xml

@@ -217,7 +217,7 @@ Zend_Session::setOptions($config->toArray());
 
     <sect2 id="zend.session.global_session_management.headers_sent">
 
-        <title>Error: Headers Already Sent</title>
+        <title>エラー: すでに送信されたヘッダ</title>
 
         <para>
             "Cannot modify header information - headers already sent"

documentation/manual/ja/module_specs/Zend_Tool_Framework-WritingProviders.xml

@@ -14,6 +14,7 @@
     <sect2 id="zend.tool.framework.writing-providers.loading">
         <title>Zend_Tool はどのようにプロバイダを見つけるか</title>
 
+        <!-- TODO : to be translated -->
         <para>
             By default <classname>Zend_Tool</classname> uses the IncludePathLoader to find all
             the providers that you can run. It recursivly iterates all
@@ -138,6 +139,7 @@ Hello from my provider!
     <sect2 id="zend.tool.framework.writing-providers.response">
         <title>レスポンスオブジェクト</title>
 
+        <!-- TODO : to be translated -->
         <para>
             As discussed in the architecture section <classname>Zend_Tool</classname> allows to hook different clients for
             using your <classname>Zend_Tool</classname> providers. To keep compliant with different clients you should
@@ -213,6 +215,7 @@ class My_Component_HelloProvider
         </sect3>
 
         <sect3 id="zend.tool.framework.writing-providers.advanced.prompt">
+            <!-- TODO : to be translated -->
             <title>Prompt the User for Input</title>
 
             <para>
@@ -296,6 +299,7 @@ I would say hello Ralph.
         <sect3 id="zend.tool.framework.writing-providers.advanced.verbosedebug">
             <title>冗長及びデバッグモード</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 You can also run your provider actions in "verbose" or "debug" modes.
                 The semantics in regard to this actions have to be implemented by you
@@ -323,6 +327,7 @@ class My_Component_HelloProvider
         <sect3 id="zend.tool.framework.writing-providers.advanced.configstorage">
             <title>ユーザーの構成及びストレージにアクセス</title>
 
+            <!-- TODO : to be translated -->
             <para>
                 Using the Enviroment variable <property>ZF_CONFIG_FILE</property> or the
                 .zf.ini in your home directory you can inject configuration parameters into
@@ -389,6 +394,7 @@ class Zend_Tool_Framework_Client_Storage
 }
 ]]></programlisting>
 
+            <!-- TODO : to be translated -->
             <important>
                 <para>
                     When designing your providers that are config or storage aware remember to

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

@@ -18,19 +18,20 @@
             <classname>Zend_Validate_Ip</classname> では、下記のオプションがサポートされます。
         </para>
 
-        <!-- TODO : to be translated -->
         <itemizedlist>
             <listitem>
                 <para>
-                    <emphasis><property>allowipv4</property></emphasis>: Defines if the validator
-                    allows IPv4 adresses. This option defaults to <constant>TRUE</constant>.
+                    <emphasis><property>allowipv4</property></emphasis>:
+                    バリデータが IPv4 アドレスを許すかどうかを定義します。
+                    このオプションのデフォルトは <constant>TRUE</constant> です。
                 </para>
             </listitem>
 
             <listitem>
                 <para>
-                    <emphasis><property>allowipv6</property></emphasis>: Defines if the validator
-                    allows IPv6 adresses. This option defaults to <constant>TRUE</constant>.
+                    <emphasis><property>allowipv6</property></emphasis>:
+                    バリデータが IPv6 アドレスを許すかどうかを定義します。
+                    このオプションのデフォルトは <constant>TRUE</constant> です。
                 </para>
             </listitem>
         </itemizedlist>

documentation/manual/ja/module_specs/Zend_Version.xml

@@ -31,6 +31,7 @@ $cmp = Zend_Version::compareVersion('2.0.0');
 ]]></programlisting>
     </example>
 
+    <!-- TODO : to be translated -->
     <para>
         The static method <methodname>Zend_Version::getLatest()</methodname> provides the version 
         number of the last stable release available for download on the site 

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

@@ -110,8 +110,9 @@ $this->headStyle()->appendStyle($styles, array('conditional' => 'lt IE 7'));
     </para>
 
     <note>
-        <title>UTF-8 encoding used by default</title>
+        <title>デフォルトで使用される UTF-8 エンコーディング</title>
 
+        <!-- TODO : to be translated -->
         <para>
             By default, Zend Framework uses <acronym>UTF-8</acronym> as its default encoding, and,
             specific to this case, <classname>Zend_View</classname> does as well. Character encoding

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

@@ -27,6 +27,7 @@
         や 'SET' (スタック全体を上書きする) にすることもできます。
     </para>
 
+    <!-- TODO : to be translated -->
     <para>
         Since setting the aggregating (attach) order on each call to <methodname>
         headTitle</methodname> can be cumbersome, you can set a default attach order

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

@@ -570,6 +570,7 @@ class My_View_Helper_ScriptPath
         </para>
     </sect2>
 
+    <!-- TODO : to be translated -->
     <sect2 id="zend.view.helpers.registering-concrete">
         <title>Registering Concrete Helpers</title>
 

documentation/manual/ja/ref/coding_standard.xml

@@ -189,6 +189,7 @@
                     将来のバージョンでは規約に従うよう名前が変わる予定です。
                 </para>
 
+                <!-- TODO : to be translated -->
                 <para>
                     The rationale for the change is due to namespace usage. As we look towards Zend
                     Framework 2.0 and usage of <acronym>PHP</acronym> 5.3, we will be using