sync en

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

documentation/manual/ja/module_specs/Zend_Controller-ActionHelpers-ContextSwitch.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20765 -->
+<!-- EN-Revision: 21824 -->
 <sect3 id="zend.controller.actionhelpers.contextswitch">
     <title>ContextSwitch および AjaxContext</title>
 
@@ -145,7 +145,7 @@ class NewsController extends Zend_Controller_Action
 
         <para>
             <emphasis>ContextSwitch</emphasis> ヘルパーで
-            使用できるデフォルトのコンテキストは、json と xml のふたつです。
+            使用できるデフォルトのコンテキストは、json と <acronym>XML</acronym> のふたつです。
         </para>
 
         <itemizedlist>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21606 -->
+<!-- EN-Revision: 21825 -->
 <sect1 id="zend.form.decorators">
     <title>Zend_Form_Decorator による独自のフォームマークアップの作成</title>
 
@@ -174,7 +174,7 @@ interface Zend_Form_Decorator_Interface
             たとえば、使用するデコレータの数を減らすために
             "複合" デコレータを作成することにしましょう。
             このデコレータでは、ラベルや要素、エラーメッセージ、
-            そして説明を HTML の 'div' でレンダリングします。
+            そして説明を <acronym>HTML</acronym> の 'div' でレンダリングします。
             この 'Composite' デコレータは、次のようになります。
         </para>
 

documentation/manual/ja/module_specs/Zend_Gdata_Gbase.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20779 -->
+<!-- EN-Revision: 22397 -->
 <sect1 id="zend.gdata.gbase">
     <title>Google Base の使用法</title>
     <para>
@@ -207,11 +207,14 @@ session_start();
 // AuthSub サーバにリダイレクトします
 $service = new Zend_Gdata_Gbase(getAuthSubHttpClient());
 ]]></programlisting>
-<para>最後に、snippets フィード用の未認証のサーバを作成する方法を示します。</para>
-<programlisting language="php"><![CDATA[
+
+            <para>最後に、snippets フィード用の未認証のサーバを作成する方法を示します。</para>
+
+            <programlisting language="php"><![CDATA[
 // Base サービスのインスタンスを、未認証の HTTP クライアントで作成します
 $service = new Zend_Gdata_Gbase();
 ]]></programlisting>
+
         </sect3>
     </sect2>
     <sect2 id="zend.gdata.gbase.retrieve">
@@ -284,8 +287,8 @@ $feed = $service->getGbaseSnippetFeed($query);
         <sect3 id="zend.gdata.gbase.retrieve.iterate">
             <title>アイテムに対する順次処理</title>
             <para>
-                Google Base のアイテムには、<code>&lt;g:main_ingredient&gt;</code>
-                や <code>&lt;g:weight&gt;</code> といったアイテム固有の属性が含まれています。
+                Google Base のアイテムには、<emphasis>&lt;g:main_ingredient&gt;</emphasis>
+                や <emphasis>&lt;g:weight&gt;</emphasis> といったアイテム固有の属性が含まれています。
             </para>
             <para>
                 指定したアイテムのすべての属性を順に処理するには、

documentation/manual/ja/module_specs/Zend_Layout-Advanced.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 22432 -->
 <sect1 id="zend.layout.advanced">
     <title>Zend_Layout の高度な使用法</title>
 
@@ -114,7 +114,7 @@ $layoutVars   = $placeholders->placeholder('Zend_Layout')->getArrayCopy();
             もし独自のプラグインを作成したい場合は、
             作成したプラグインクラスの名前を
             <methodname>startMvc()</methodname> メソッドの
-            <code>pluginClass</code> オプションで指定します。
+            <property>pluginClass</property> オプションで指定します。
         </para>
 
         <para>
@@ -151,7 +151,7 @@ $layoutVars   = $placeholders->placeholder('Zend_Layout')->getArrayCopy();
             を継承したアクションヘルパークラスを作成します。
             そして、そのクラス名を
             <methodname>startMvc()</methodname> メソッドの
-            <code>helperClass</code> オプションに指定します。
+            <property>helperClass</property> オプションに指定します。
             実装の詳細は自由に決められます。
         </para>
     </sect2>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22432 -->
 <sect1 id="zend.layout.quickstart">
     <title>Zend_Layout クイックスタート</title>
 
@@ -112,7 +112,7 @@
             また、アクションヘルパーを登録して、
             アクションコントローラからレイアウトオブジェクトにアクセスできるようにします。
             さらに、ビュースクリプトからレイアウトのインスタンスを取得するには
-            <code>layout</code> ビューヘルパーを使用します。
+            <classname>Layout</classname> ビューヘルパーを使用します。
         </para>
 
         <para>
@@ -156,7 +156,7 @@ class FooController extends Zend_Controller_Action
 ]]></programlisting>
 
         <para>
-            ビュースクリプトでは、<code>layout</code>
+            ビュースクリプトでは、<classname>Layout</classname>
             ビューヘルパーを用いてレイアウトオブジェクトにアクセスします。
             このビューヘルパーは、他のヘルパーとは異なり引数を受け取りません。
             そして文字列ではなくオブジェクトを返します。

documentation/manual/ja/module_specs/Zend_Ldap-API-Ldap-Node-RootDse.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 21821 -->
 <sect3 id="zend.ldap.api.reference.zend-ldap-node-rootdse">
     <title>Zend_Ldap_Node_RootDse</title>
 
@@ -34,7 +34,7 @@
             <tbody>
                 <row>
                     <entry><code>Zend_Ldap_Dn getDn()</code></entry>
-                    <entry>Zend_Ldap_Dn として現行ノードの DN を取得</entry>
+                    <entry><classname>Zend_Ldap_Dn</classname> として現行ノードの DN を取得</entry>
                 </row>
                 <row>
                     <entry><code>string getDnString(string $caseFold)</code></entry>

documentation/manual/ja/module_specs/Zend_Ldap-API-Ldap-Node-Schema.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 21821 -->
 <sect3 id="zend.ldap.api.reference.zend-ldap-node-schema">
     <title>Zend_Ldap_Node_Schema</title>
 
@@ -34,7 +34,7 @@
             <tbody>
                 <row>
                     <entry><code>Zend_Ldap_Dn getDn()</code></entry>
-                    <entry>Zend_Ldap_Dn として現行ノードの DN を取得します。</entry>
+                    <entry><classname>Zend_Ldap_Dn</classname> として現行ノードの DN を取得します。</entry>
                 </row>
                 <row>
                     <entry><code>string getDnString(string $caseFold)</code></entry>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21790 -->
+<!-- EN-Revision: 21816 -->
 <sect1 id="zend.locale.introduction">
 
     <title>導入</title>
@@ -294,7 +294,7 @@ $locale3 = new Zend_Locale(Zend_Locale::FRAMEWORK);
                     <para>
                         <code>'browser'</code> - <classname>Zend_Locale</classname>
                         は、ユーザが使用するウェブブラウザが提供する情報を使用します。
-                        これは、<acronym>PHP</acronym> のグローバル変数 <constant>HTTP_ACCEPT_LANGUAGE</constant>
+                        これは、<acronym>PHP</acronym> のグローバル変数 <constant>$_SERVER['HTTP_ACCEPT_LANGUAGE']</constant>
                         で取得します。
                     </para>
                     <para>

documentation/manual/ja/module_specs/Zend_Mail-CharacterSets.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20819 -->
+<!-- EN-Revision: 21992 -->
 <sect1 id="zend.mail.character-sets">
     <title>文字セット</title>
 
@@ -38,8 +38,13 @@ function myConvert($string) {
 }
 
 $mail = new Zend_Mail('ISO-2022-JP');
-//この場合、 ISO-2022-JP は MSB を使わないので、 ENCODING_7BIT を使えます。
-$mail->setBodyText(myConvert('This is the text of the mail.'), null, Zend_Mime::ENCODING_7BIT);
+//この場合、 ISO-2022-JP は MSB を使わないので、
+// ENCODING_7BIT を使えます。
+$mail->setBodyText(
+    myConvert('This is the text of the mail.'),
+    null,
+    Zend_Mime::ENCODING_7BIT
+);
 $mail->setHeaderEncoding(Zend_Mime::ENCODING_BASE64);
 $mail->setFrom('somebody@example.com', myConvert('Some Sender'));
 $mail->addTo('somebody_else@example.com', myConvert('Some Recipient'));

documentation/manual/ja/module_specs/Zend_Mail-Introduction.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 21825 -->
 <sect1 id="zend.mail.introduction">
 
     <title>導入</title>
@@ -45,7 +45,7 @@ $mail->send();
             <para>
                 <classname>Zend_Mail</classname> でメールを送信するには、
                 最低 1 か所以上の受信者、送信者 (<methodname>setFrom()</methodname> を使用します)、
-                そして本文 (テキストや HTML) を指定しなければなりません。
+                そして本文 (テキストや <acronym>HTML</acronym>) を指定しなければなりません。
             </para>
         </note>
 

documentation/manual/ja/module_specs/Zend_ProgressBar_Adapter_JsPush.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 22210 -->
 <sect3 id="zend.progressbar.adapter.jspush">
     <title>Zend_ProgressBar_Adapter_JsPush</title>
     <para>
@@ -34,7 +34,7 @@
     <para>
         このアダプタの使い方はきわめて単純です。まず、ブラウザ上にプログレスバーを作成します。
         これは JavaScript を用いたものでもかまいませんしプレーンな
-        HTML によるものでもかまいません。それから、更新時のメソッドと
+        <acronym>HTML</acronym> によるものでもかまいません。それから、更新時のメソッドと
         終了時のメソッド (オプション) を JavaScript で定義します。
         これらのメソッドは、どちらも唯一の引数として json オブジェクトを受け取るようにします。
         そして、処理時間が長くかかるウェブページを
@@ -78,7 +78,7 @@
     <example id="zend.progressbar-adapter.jspush.example">
         <title>クライアント側の基本例</title>
         <para>
-            この例では、JsPush アダプタ用の HTML および <acronym>CSS</acronym>、JavaScript
+            この例では、JsPush アダプタ用の <acronym>HTML</acronym> および <acronym>CSS</acronym>、JavaScript
             の基本的な設定方法を示します。
         </para>
         <programlisting language="html"><![CDATA[
@@ -116,7 +116,8 @@
         <programlisting language="javascript"><![CDATA[
 function Zend_ProgressBar_Update(data)
 {
-    document.getElementById('zend-progressbar-done').style.width = data.percent + '%';
+    document.getElementById('zend-progressbar-done').style.width =
+         data.percent + '%';
 }
 ]]></programlisting>
 

documentation/manual/ja/module_specs/Zend_Service-ReCaptcha.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20810 -->
+<!-- EN-Revision: 21819 -->
 <sect1 id="zend.service.recaptcha">
     <title>Zend_Service_ReCaptcha</title>
 
@@ -120,7 +120,7 @@ if (!$result->isValid()) {
 
         <para>
             このコンポーネントを使うには、
-            mailhide API 用の公開キーと秘密キーを生成するための
+            mailhide <acronym>API</acronym> 用の公開キーと秘密キーを生成するための
             <ulink url="http://recaptcha.net/whyrecaptcha.html">アカウント</ulink>
             が必要です。
         </para>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21741 -->
+<!-- EN-Revision: 21888 -->
 <sect1 id="zend.tool.framework.writing-providers">
     <title>Zend_Tool_Frameworkを利用してプロバイダを作成する</title>
 
@@ -230,7 +230,7 @@ class My_Component_HelloProvider
         $nameResponse = $this->_registry
                              ->getClient()
                              ->promptInteractiveInput("Whats your name?");
-        $name = $name->getContent();
+        $name = $nameResponse->getContent();
 
         echo 'Hello' . $name . ', from my provider!';
     }
@@ -373,7 +373,7 @@ class My_Component_HelloProvider
 ]]></programlisting>
 
             <para>
-                ストレージ API はとても簡単です。
+                ストレージ <acronym>API</acronym> はとても簡単です。
             </para>
 
             <programlisting language="php"><![CDATA[

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21661 -->
+<!-- EN-Revision: 22585 -->
 <sect1 id="zend.translate.adapter">
     <title>Zend_Translate のアダプタ</title>
 
@@ -43,7 +43,7 @@
 
                 <row>
                     <entry>Ini</entry>
-                    <entry>シンプルな ini ファイル (*.ini)</entry>
+                    <entry>シンプルな <acronym>INI</acronym> ファイル (*.ini)</entry>
                     <entry>シンプルなテキスト形式。高速。Unicode 文字で問題が発生する可能性がある。</entry>
                 </row>
 
@@ -298,7 +298,7 @@
 
             <para>
                 XmlTm アダプタは、すでにこのレイアウトを採用している顧客が使用するアダプタです。
-                XmlTm は、html ソース全体を翻訳ソースに含めることのできるフォーマットで、
+                XmlTm は、 <acronym>HTML</acronym> ソース全体を翻訳ソースに含めることのできるフォーマットで、
                 翻訳とレイアウトがひとつにまとまります。
                 XLIFF は <acronym>XML</acronym> ベースのフォーマットです。XLIFF
                 と関連していますが、それほど読みやすくはありません。
@@ -374,6 +374,7 @@ try {
             <methodname>removeCache()</methodname> も用意されています。
         </para>
 
+        <!-- TODO : to be translated -->
         <programlisting language="php"><![CDATA[
 $cache = Zend_Cache::factory('Core',
                              'File',
@@ -387,6 +388,9 @@ $translate = new Zend_Translate(
         'locale'  => 'en'
     )
 );
+
+// to clear the cache somewhere later in your code
+Zend_Translate::clearCache();
 ]]></programlisting>
 
         <note>
@@ -399,6 +403,37 @@ $translate = new Zend_Translate(
                 翻訳ソースのキャッシュは行われません。
             </para>
         </note>
+
+        <para>
+            When the attached cache supports tagging you can set a own tag string by using the
+            option <property>tag</property>. This allows you do delete only the cache from this
+            single instance of <classname>Zend_Translate</classname>. When you are not using this
+            option the default tag <classname>Zend_Translate</classname> is used.
+        </para>
+
+        <para>
+            Using the option <property>tag</property> you must give the used tag to
+            <methodname>clearCache()</methodname> to declare which tag you want to delete.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$cache = Zend_Cache::factory('Core',
+                             'File',
+                             $frontendOptions,
+                             $backendOptions);
+Zend_Translate::setCache($cache);
+$translate = new Zend_Translate(
+    array(
+        'adapter' => 'gettext',
+        'content' => '/path/to/translate.mo',
+        'locale'  => 'en',
+        'tag'     => 'MyTag'
+    )
+);
+
+// somewhere later in your code
+Zend_Translate::clearCache('MyTag');
+]]></programlisting>
     </sect2>
 </sect1>
 <!--

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 22146 -->
 <sect2 id="zend.validate.set.ip">
 
     <title>Ip</title>
@@ -56,7 +56,7 @@ if ($validator->isValid($ip)) {
 
             <para>
                 <classname>Zend_Validate_Ip</classname> は IP アドレスだけを検証することを記憶にとどめてください。
-                'mydomain.com' や '192.168.50.1/index.html' のようなアドレスは、有効な IP アドレスではありません。
+                '<filename>mydomain.com</filename>' や '<filename>192.168.50.1/index.html</filename>' のようなアドレスは、有効な IP アドレスではありません。
                 それらは IP アドレスではなく、 hostname または 有効な <acronym>URL</acronym> です。
             </para>
         </note>
@@ -66,7 +66,7 @@ if ($validator->isValid($ip)) {
 
             <para>
                 <classname>Zend_Validate_Ip</classname> は正規表現で IPv6 アドレスを検証します。
-                それは、 <acronym>PHP</acronym> 自身のフィルターやメソッドが RFC に準拠していないからです。
+                それは、 <acronym>PHP</acronym> 自身のフィルターやメソッドが <acronym>RFC</acronym> に準拠していないからです。
                 他の多くの利用可能なクラスもまた、それに準拠しません。
             </para>
         </note>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21661 -->
+<!-- EN-Revision: 21992 -->
 <sect1 id="zend.validate.messages">
 
     <title>検証メッセージ</title>
@@ -46,7 +46,10 @@ $messages  = $validator->getMessageTemplates();
 
     <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_GreaterThan();
-$validator->setMessage('Please enter a lower value', Zend_Validate_GreaterThan::NOT_GREATER);
+$validator->setMessage(
+    'Please enter a lower value',
+    Zend_Validate_GreaterThan::NOT_GREATER
+);
 ]]></programlisting>
 
     <para>

documentation/manual/ja/module_specs/Zend_XmlRpc_Server.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 22468 -->
 <sect1 id="zend.xmlrpc.server">
     <title>Zend_XmlRpc_Server</title>
 
@@ -689,21 +689,21 @@ echo $server->handle($request);
                 extension <code>ext/dom</code> to generate it's
                 <acronym>XML</acronym> output. While <code>ext/dom</code> is
                 available on a lot of hosts it is not exactly the fastest.
-                Benchmarks have shown, that <classname>XMLWriter</classname>
+                Benchmarks have shown, that <classname>XmlWriter</classname>
                 from <code>ext/xmlwriter</code> performs better.
             </para>
 
             <para>
                 If <code>ext/xmlwriter</code> is available on your host, you can
-                select a the <classname>XMLWriter</classname>-based generator
+                select a the <classname>XmlWriter</classname>-based generator
                 to leaverage the performance differences.
             </para>
 
             <programlisting language="php"><![CDATA[
 require_once 'Zend/XmlRpc/Server.php';
-require_once 'Zend/XmlRpc/Generator/XMLWriter.php';
+require_once 'Zend/XmlRpc/Generator/XmlWriter.php';
 
-Zend_XmlRpc_Value::setGenerator(new Zend_XmlRpc_Generator_XMLWriter());
+Zend_XmlRpc_Value::setGenerator(new Zend_XmlRpc_Generator_XmlWriter());
 
 $server = new Zend_XmlRpc_Server();
 ...