sync mainly 21829

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22432 -->
 <sect1 id="zend.json.basics">
     <title>基本的な使用法</title>
     <para>
@@ -38,7 +38,7 @@ if($debug) {
 
         <para>
             Second optional argument of <methodname>Zend_Json::prettyPrint()</methodname> is an option array.
-            Option <code>indent</code> allows to set indentation string - by default it's a single tab character.
+            Option <property>indent</property> allows to set indentation string - by default it's a single tab character.
         </para>
     </sect2>
 </sect1>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 23305 -->
 <sect1 id="zend.reflection.examples">
     <title>Zend_Reflectionサンプル</title>
 
@@ -54,11 +54,7 @@ $file = $r->getDeclaringFile();
         <programlisting language="php"><![CDATA[
 $r = new Zend_Reflection_Method($class, $name);
 
-printf(
-"The method '%s' has a return type of %s",
-    $r->getName(),
-    $r->getReturn()
-);
+printf( "Method '%s':\n", $r->getName());
 
 foreach ($r->getParameters() as $key => $param) {
     printf(

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21305 -->
+<!-- EN-Revision: 22743 -->
 <sect1 id="zend.session.global_session_management">
 
     <title>グローバルセッションの管理</title>
@@ -524,7 +524,7 @@ if (!isset($defaultNamespace->initialized)) {
             "Cannot modify header information - headers already sent"
             というエラーが出た場合は、最初の引数として <constant>TRUE</constant>
             (セッションクッキーを削除) を使用しないようにするか、あるいは
-            <xref linkend="zend.session.global_session_management.headers_sent" /> を参照ください。
+            <link linkend="zend.session.global_session_management.headers_sent">このセクション</link>を参照してください。
             つまり、<methodname>Zend_Session::destroy(true)</methodname> をコールするなら
             PHP が HTTP ヘッダを送信する前にするか、
             あるいは出力バッファリングを有効にしなければなりません。

documentation/manual/ja/module_specs/Zend_Soap_AutoDiscovery.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20810 -->
+<!-- EN-Revision: 22743 -->
 <sect1 id="zend.soap.autodiscovery">
     <title>自動検出</title>
 
@@ -80,8 +80,9 @@
         <para>
             これは自動検出機能の一般的な用法の例です。
             <methodname>handle()</methodname>関数はWSDLファイルを生成してブラウザーにポストします。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 class My_SoapServer_Class {
 ...
 }
@@ -90,7 +91,6 @@ $autodiscover = new Zend_Soap_AutoDiscover();
 $autodiscover->setClass('My_SoapServer_Class');
 $autodiscover->handle();
 ]]></programlisting>
-        </para>
 
         <para>
             ファイルまたは<acronym>XML</acronym>ストリングとして保存するために生成されたWSDLファイルへのアクセスも必要ならば、
@@ -116,8 +116,7 @@ $autodiscover->handle();
                 <classname>Zend_Soap_Server</classname>クラスを準備しなくてはいけません。
             </para>
 
-            <para>
-                <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 if(isset($_GET['wsdl'])) {
     $autodiscover = new Zend_Soap_AutoDiscover();
     $autodiscover->setClass('HelloWorldService');
@@ -129,7 +128,6 @@ if(isset($_GET['wsdl'])) {
     $soap->handle();
 }
 ]]></programlisting>
-            </para>
         </note>
     </sect2>
 
@@ -139,12 +137,13 @@ if(isset($_GET['wsdl'])) {
         <para>
             クラスが<acronym>SOAP</acronym>サーバー機能を提供することに使われるならば、
             同じクラスはWSDL生成のために<classname>Zend_Soap_AutoDiscover</classname>に提供されなければなりません:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $autodiscover = new Zend_Soap_AutoDiscover();
 $autodiscover->setClass('My_SoapServer_Class');
 $autodiscover->handle();
 ]]></programlisting>
-        </para>
 
         <para>
             WSDL生成の間、以下の規則が使われます:
@@ -207,7 +206,9 @@ $autodiscover->handle();
         <para>
             関数のセットが<acronym>SOAP</acronym>サーバー機能を提供することに使われるならば、
             同じセットはWSDL生成のために<classname>Zend_Soap_AutoDiscovery</classname>に提供されなければなりません:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $autodiscover = new Zend_Soap_AutoDiscover();
 $autodiscover->addFunction('function1');
 $autodiscover->addFunction('function2');
@@ -215,7 +216,6 @@ $autodiscover->addFunction('function3');
 ...
 $autodiscover->handle();
 ]]></programlisting>
-        </para>
 
         <para>
             WSDL生成の間、以下の規則が使われます:
@@ -298,7 +298,7 @@ $autodiscover->handle();
                 </listitem>
                 <listitem>
                     <para>
-                        <acronym>PHP</acronym>クラス &lt;-&gt; 複雑な型のストラテジーに基づいた (<xref linkend="zend.soap.wsdl.types.add_complex" />参照)
+                        <acronym>PHP</acronym>クラス &lt;-&gt; 複雑な型のストラテジーに基づいた (<link linkend="zend.soap.wsdl.types.add_complex">このセクション</link>参照)
                         <footnote>
                             <para>
                                 <classname>Zend_Soap_AutoDiscover</classname>は複雑な型のための検出アルゴリズムとして
@@ -343,8 +343,7 @@ $autodiscover->handle();
             スタイルを設定できます。
         </para>
 
-        <para>
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $autodiscover = new Zend_Soap_AutoDiscover();
 // デフォルトは 'use' => 'encoded' 及び
 // 'encodingStyle' => 'http://schemas.xmlsoap.org/soap/encoding/' です。
@@ -363,6 +362,5 @@ $autodiscover->setBindingStyle(
 $autodiscover->addFunction('myfunc1');
 $autodiscover->handle();
 ]]></programlisting>
-        </para>
     </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Soap_Server.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21824 -->
+<!-- EN-Revision: 21829 -->
 <sect1 id="zend.soap.server">
     <title>Zend_Soap_Server</title>
 
@@ -174,7 +174,9 @@
         <para>
             最初の一つは、ウェブサービス<acronym>API</acronym>を完全に記述しなければならない<classname>Zend_Soap_Server</classname>オブジェクトに対して、
             いくつかのクラスを付与することです:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 ...
 class MyClass {
     /**
@@ -209,19 +211,22 @@ $server->setObject(new MyClass());
 ...
 $server->handle();
 ]]></programlisting>
-            <note>
-                <title>重要</title>
-                <para>
-                    対応するウェブサービスWSDLを準備するautodiscover機能を使うつもりならば、
-                    メソッドdocblockを使って各々のメソッドを完全に記述しなければなりません。
-                </para>
-            </note>
-        </para>
+
+        <note>
+            <title>重要</title>
+
+            <para>
+                対応するウェブサービスWSDLを準備するautodiscover機能を使うつもりならば、
+                メソッドdocblockを使って各々のメソッドを完全に記述しなければなりません。
+            </para>
+        </note>
 
         <para>
             ウェブサービス<acronym>API</acronym>を定義する２つ目の方法は、
             関数のセットや<methodname>addFunction()</methodname>または<methodname>loadFunctions()</methodname>メソッドを使うことです:
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 ...
 /**
  * この関数は...
@@ -250,7 +255,6 @@ $server->addFunction('function2');
 ...
 $server->handle();
 ]]></programlisting>
-        </para>
     </sect2>
 
     <sect2 id="zend.soap.server.request_response">
@@ -277,7 +281,9 @@ $server->handle();
                 それは、<methodname>handle()</methodname>メソッドにオプションのパラメータを供給することによって、
                 または、<methodname>setRequest()</methodname>メソッドを用いてリクエストを設定することによって
                 上書きされるかもしれません:
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 ...
 $server = new Zend_Soap_Server(...);
 ...
@@ -288,7 +294,6 @@ $server->handle($request);
 $server->setRequest();
 $server->handle();
 ]]></programlisting>
-            </para>
 
             <para>
                 リクエストオブジェクトは以下のどれかを用いて表されるかもしれません:
@@ -324,15 +329,15 @@ $server->handle();
 
             <para>
                 最後に処理されたリクエストは<methodname>getLastRequest()</methodname>メソッドを使って<acronym>XML</acronym>文字列として取得されます:
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 ...
 $server = new Zend_Soap_Server(...);
 ...
 $server->handle();
 $request = $server->getLastRequest();
 ]]></programlisting>
-
-            </para>
         </sect3>
 
         <sect3 id="zend.soap.server.request_response.response">
@@ -349,7 +354,9 @@ $request = $server->getLastRequest();
                     </para>
                 </footnote>
                 生成されたレスポンスはこの場合、<methodname>handle()</methodname>メソッドにより戻されます。
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 ...
 $server = new Zend_Soap_Server(...);
 ...
@@ -360,11 +367,12 @@ $server->setReturnResponse(true);
 $response = $server->handle();
 ...
 ]]></programlisting>
-            </para>
 
             <para>
                 ある処理のために、最後のレスポンスを<methodname>getLastResponse()</methodname>メソッドで取得することもできます:
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 ...
 $server = new Zend_Soap_Server(...);
 ...
@@ -372,7 +380,6 @@ $server->handle();
 $response = $server->getLastResponse();
 ...
 ]]></programlisting>
-            </para>
         </sect3>
     </sect2>
 </sect1>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 22760 -->
 <sect1 id="zend.translate.using">
 
     <title>翻訳アダプタの使用法</title>
@@ -71,8 +71,9 @@ print $translate->_("Here is line two") . "\n";
 
     <para>
         新しい <classname>Zend_Translate</classname> オブジェクトを作成し、もととなるアダプタを定義します。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $translate = new Zend_Translate(
     array(
         'adapter' => 'gettext',
@@ -82,6 +83,7 @@ $translate = new Zend_Translate(
 );
 ]]></programlisting>
 
+    <para>
         この例では、
         <emphasis>Gettext アダプタ</emphasis>
         を使うことにしました。
@@ -94,13 +96,15 @@ $translate = new Zend_Translate(
     <para>
         次に行うのは、翻訳対象の文字列をすべてラップすることです。
         一番シンプルな手法は、このように文字列や文章を囲むことです。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 print $translate->_("Example") . "\n";
 print "=======\n";
 print $translate->_("Here is line one") . "\n";
 ]]></programlisting>
 
+    <para>
         中には翻訳する必要のない文字列もあるでしょう。
         区切り線などは、たとえ言語が何であっても同じです。
     </para>
@@ -108,14 +112,16 @@ print $translate->_("Here is line one") . "\n";
     <para>
         データの値を翻訳文字列に組み込むこともできます。
         この場合は埋め込みパラメータを使用します。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 printf($translate->_("Today is the %1\$s") . "\n", date("d.m.Y"));
 ]]></programlisting>
 
+    <para>
         <methodname>print()</methodname> の代わりに <methodname>printf()</methodname> 関数を使用し、
-        すべてのパラメータを <code>%1\$s</code> のように置き換えます。
-        最初のパラメータが <code>%1\$s</code>、その次が <code>%2\$s</code>、
+        すべてのパラメータを <emphasis>%1\$s</emphasis> のように置き換えます。
+        最初のパラメータが <emphasis>%1\$s</emphasis>、その次が <emphasis>%2\$s</emphasis>、
         といったようになります。
         これにより、実際の値を知らなくても翻訳を進めることができます。
         今回の例では、日付は常に今日の日付になります。
@@ -126,13 +132,15 @@ printf($translate->_("Today is the %1\$s") . "\n", date("d.m.Y"));
         各文字列は、メッセージ ID によって識別します。
         文字列の代わりに、コード内でメッセージ ID を指定することもできます。
         その場合は、このようになります。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 print $translate->_(1) . "\n";
 print "=======\n";
 print $translate->_(2) . "\n";
 ]]></programlisting>
 
+    <para>
         しかし、この方法にはいくつか欠点があります。
     </para>