sync mainly 21829

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

documentation/manual/ja/module_specs/Zend_Search_Lucene-BestPractice.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20854 -->
+<!-- EN-Revision: 21829 -->
 <sect1 id="zend.search.lucene.best-practice">
     <title>ベストプラクティス</title>
 
@@ -26,8 +26,9 @@
             を表します。もしドキュメントでこれらと同じ名前のフィールドを使っているのなら、
             そのフィールドにアクセスするには <methodname>getDocument()</methodname>
             メソッドを使う必要があります。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $hits = $index->find($query);
 
 foreach ($hits as $hit) {
@@ -53,7 +54,6 @@ foreach ($hits as $hit) {
     $title = $hit->getDocument()->title;
 }
 ]]></programlisting>
-        </para>
     </sect2>
 
     <sect2 id="zend.search.lucene.best-practice.indexing-performance">
@@ -83,12 +83,13 @@ foreach ($hits as $hit) {
 
         <para>
             インデックスの最適化を行うには <methodname>optimize()</methodname> メソッドを使用します。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $index = Zend_Search_Lucene::open($indexPath);
 
 $index->optimize();
 ]]></programlisting>
-        </para>
 
         <para>
             インデックスの最適化はデータストリーム上で行われるので、
@@ -312,21 +313,26 @@ $index->optimize();
 
         <para>
             まずは、強制的にスコープ外に出す方法です。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $index = Zend_Search_Lucene::open($indexPath);
 
 ...
 
 unset($index);]]></programlisting>
-        </para>
 
         <para>
             そしてもうひとつは、スクリプトの終了前にコミット操作を行うことです。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $index = Zend_Search_Lucene::open($indexPath);
 
 $index->commit();
 ]]></programlisting>
+
+        <para>
             これについては、このドキュメントの
             "<link linkend="zend.search.lucene.advanced.static">応用: 静的プロパティとしてのインデックスの使用</link>"
             でも説明しています。
@@ -348,8 +354,10 @@ $index->commit();
 
         <para>
             これは <methodname>find()</methodname> メソッドよりも効率的です。
-            <programlisting language="php"><![CDATA[
-// find() メソッドでクエリ文字列を指定することによるドキュメントの取得
+        </para>
+
+        <programlisting language="php"><![CDATA[
+// find() メソッドでクエリ文字列を指定してドキュメントを取得
 $query = $idFieldName . ':' . $docId;
 $hits  = $index->find($query);
 foreach ($hits as $hit) {
@@ -359,7 +367,7 @@ foreach ($hits as $hit) {
 }
 ...
 
-// find() メソッドでクエリ API を使用することによるドキュメントの取得
+// find() メソッドでクエリ API を使用してドキュメントを取得
 $term = new Zend_Search_Lucene_Index_Term($docId, $idFieldName);
 $query = new Zend_Search_Lucene_Search_Query_Term($term);
 $hits  = $index->find($query);
@@ -371,7 +379,7 @@ foreach ($hits as $hit) {
 
 ...
 
-// termDocs() メソッドによるドキュメントの取得
+// termDocs() メソッドでドキュメントを取得
 $term = new Zend_Search_Lucene_Index_Term($docId, $idFieldName);
 $docIds  = $index->termDocs($term);
 foreach ($docIds as $id) {
@@ -381,7 +389,6 @@ foreach ($docIds as $id) {
     ...
 }
 ]]></programlisting>
-        </para>
     </sect2>
 
     <sect2 id="zend.search.lucene.best-practice.memory-usage">
@@ -464,7 +471,9 @@ foreach ($docIds as $id) {
 
         <para>
             フィールドを作成するメソッドで、エンコーディングをオプションのパラメータによって指定できます。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $doc = new Zend_Search_Lucene_Document();
 $doc->addField(Zend_Search_Lucene_Field::Text('title',
                                               $title,
@@ -473,13 +482,17 @@ $doc->addField(Zend_Search_Lucene_Field::UnStored('contents',
                                                   $contents,
                                                   'utf-8'));
 ]]></programlisting>
+
+        <para>
             エンコーディングの指定をはっきりさせるという意味で、これが最も良い方法です。
         </para>
 
         <para>
             このエンコーディング指定を省略すると、現在のロケールをもとに判断を行ないます。
             ロケールの指定時に、言語だけでなく文字セットも指定できます。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 setlocale(LC_ALL, 'fr_FR');
 ...
 
@@ -489,7 +502,6 @@ setlocale(LC_ALL, 'de_DE.iso-8859-1');
 setlocale(LC_ALL, 'ja_JP.UTF-8');
 ...
 ]]></programlisting>
-        </para>
 
         <para>
             クエリ文字列のエンコーディングも、同じ方式で指定します。
@@ -503,22 +515,27 @@ setlocale(LC_ALL, 'ja_JP.UTF-8');
         <para>
             検索の前にクエリのパースを行なう場合、
             エンコーディングはオプションのパラメータとして指定できます。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 $query =
     Zend_Search_Lucene_Search_QueryParser::parse($queryStr, 'iso-8859-5');
 $hits = $index->find($query);
 ...
 ]]></programlisting>
-        </para>
 
         <para>
             デフォルトのエンコーディングを指定するには <methodname>setDefaultEncoding()</methodname>
             メソッドを使用します。
-            <programlisting language="php"><![CDATA[
+        </para>
+
+        <programlisting language="php"><![CDATA[
 Zend_Search_Lucene_Search_QueryParser::setDefaultEncoding('iso-8859-1');
 $hits = $index->find($queryStr);
 ...
 ]]></programlisting>
+
+        <para>
             空の文字列は、'現在のロケール' を意味します。
         </para>
 

documentation/manual/ja/module_specs/Zend_Search_Lucene-Charset.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20854 -->
+<!-- EN-Revision: 21829 -->
 <sect1 id="zend.search.lucene.charset">
     <title>文字セット</title>
 
@@ -84,12 +84,12 @@
 
         <para>
              これを有効にするには、以下のようなコードを使用します。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 Zend_Search_Lucene_Analysis_Analyzer::setDefault(
     new Zend_Search_Lucene_Analysis_Analyzer_Common_Utf8());
 ]]></programlisting>
-        </para>
 
         <warning>
             <title/>
@@ -116,15 +116,15 @@ Zend_Search_Lucene_Analysis_Analyzer::setDefault(
 
         <para>
              PCRE が UTF-8 に対応しているかどうかを調べるには、次のコードを使用します。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 if (@preg_match('/\pL/u', 'a') == 1) {
     echo "PCRE は unicode をサポートしています。\n";
 } else {
     echo "PCRE は unicode をサポートしていません。\n";
 }
 ]]></programlisting>
-        </para>
 
         <para>
             大文字小文字を区別しないバージョンの UTF-8 互換解析器を使用する場合は、さらに
@@ -137,8 +137,9 @@ if (@preg_match('/\pL/u', 'a') == 1) {
             という場合は、次のようにします。
             まず、インデックス化の前に元データを正規化し、
             検索の際にはクエリ文字列を小文字に変換します。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // インデックス化
 setlocale(LC_CTYPE, 'de_DE.iso-8859-1');
 
@@ -162,7 +163,7 @@ $doc->addField(Zend_Search_Lucene_Field::UnStored('title',
 $doc->addField(Zend_Search_Lucene_Field::UnIndexed('_title', $title));
 ]]></programlisting>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 // 検索
 setlocale(LC_CTYPE, 'de_DE.iso-8859-1');
 
@@ -175,6 +176,5 @@ Zend_Search_Lucene_Analysis_Analyzer::setDefault(
 
 $hits = $index->find(strtolower($query));
 ]]></programlisting>
-        </para>
     </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Search_Lucene-QueryLanguage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 21829 -->
 <sect1 id="zend.search.lucene.query-language">
     <title>クエリ言語</title>
 
@@ -60,6 +60,7 @@
             <classname>Zend_Search_Lucene</classname> クラスにはふたつの静的メソッドがあり、
             この設定を操作できます。
         </para>
+
         <programlisting language="php"><![CDATA[
 $defaultSearchField = Zend_Search_Lucene::getDefaultSearchField();
 ...
@@ -80,30 +81,32 @@ Zend_Search_Lucene::setDefaultSearchField('contents');
             タイトルが "The Right Way" で本文に "don't go this way"
             が含まれるドキュメントを探したいなら、
         </para>
+
         <programlisting language="querystring"><![CDATA[
 title:"The Right Way" AND text:go
 ]]></programlisting>
+
         <para>
-            あるいは
+            あるいは下記にします。
+            "text" はデフォルトのフィールドなので、フィールドの指定は必須ではなくなります。
         </para>
+
         <programlisting language="querystring"><![CDATA[
 title:"Do it right" AND go
 ]]></programlisting>
-        <para>
-            とします。"text" はデフォルトのフィールドなので、フィールドの指定は必須ではなくなります。
-        </para>
 
         <para>
             注意: フィールドが有効なのは、その直後にある単語、
-            フレーズあるいはサブクエリだけであることに注意しましょう。つまり、クエリ
-            <programlisting language="querystring"><![CDATA[
-title:Do it right
-]]></programlisting>
+            フレーズあるいはサブクエリだけであることに注意しましょう。つまり、下記のクエリ
             は "Do" だけを title フィールドから探し、"it" や "right"
             はデフォルトのフィールドから探します。デフォルトのフィールドが
             <constant>NULL</constant> に設定されている場合は、"it" や "right"
             はすべてのフィールドから探します。
         </para>
+
+        <programlisting language="querystring"><![CDATA[
+title:Do it right
+]]></programlisting>
     </sect2>
 
     <sect2 id="zend.search.lucene.query-language.wildcard">
@@ -124,30 +127,31 @@ title:Do it right
         <para>
             単一文字のワイルドカードは、
             単語の中の "?" を別の一文字に置き換えたものにマッチする単語を探します。
-            たとえば、"text" あるいは "test" を探したい場合は
-            <programlisting language="querystring"><![CDATA[
+            たとえば、"text" あるいは "test" を探したい場合はこうします。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 te?t
 ]]></programlisting>
-            とします。
-        </para>
 
         <para>
             複数文字のワイルドカードは、0 個以上の任意の数の文字に対応します。
-            たとえば test、tests あるいは tester を探したい場合は
-            <programlisting language="querystring"><![CDATA[
+            たとえば test、tests あるいは tester を探したい場合はこうします。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 test*
 ]]></programlisting>
-            とします。
-        </para>
 
         <para>
             "?" や "*" は単語のどの部分でも使え、
             また両方を同時に使うこともできます。たとえば
-            <programlisting language="querystring"><![CDATA[
+            下記は、"write" や "wrote"、"written"、"rewrite"、"rewrote" などに対応します。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 *wr?t*
 ]]></programlisting>
-            は、"write" や "wrote"、"written"、"rewrite"、"rewrote" などに対応します。
-        </para>
 
         <para>
             ZF 1.7.7 以降、ワイルドカードパターンにはワイルドカード以外のプレフィックスが必要となりました。
@@ -184,29 +188,40 @@ test*
             その範囲に含まれるドキュメントを探すものです。
             最大値と最小値そのものを含めることも含めないこともできます。
             並べ替えは、辞書順で行われます。
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 mod_date:[20020101 TO 20030101]
 ]]></programlisting>
+
+        <para>
             これは、mod_date フィールドの値が 20020101 から 20030101 (両端を含む)
             であるドキュメントを探します。
             範囲検索は、日付フィールド以外でも使えることに注意しましょう。
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 title:{Aida TO Carmen}
 ]]></programlisting>
+
+        <para>
             これは、タイトルが Aida から Carmen までの間にあるドキュメントを探します。
             ただし、Aida および Carmen は含めません。
         </para>
+
         <para>
             両端の値を含めるには角括弧 []、含めない場合は波括弧 {}
             でクエリを指定します。
         </para>
+
         <para>
             フィールドを指定しなかった場合は、<classname>Zend_Search_Lucene</classname>
             はすべてのフィールドに対して範囲検索を行います。
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 {Aida TO Carmen}
 ]]></programlisting>
-        </para>
     </sect2>
 
     <sect2 id="zend.search.lucene.query-language.fuzzy">
@@ -216,23 +231,26 @@ title:{Aida TO Carmen}
             これは、レーベンシュタイン距離のアルゴリズムにもとづくものです。
             あいまい検索を行うには、チルダ記号 "~" を単語の最後に指定します。
             たとえば、"roam" と似たスペルの単語を探すには、次のようなあいまい検索を使用します。
+        </para>
 
-            <programlisting language="querystring"><![CDATA[
+        <programlisting language="querystring"><![CDATA[
 roam~
 ]]></programlisting>
 
+        <para>
             この検索は、foam あるいは roams といった単語にマッチします。
-
             (オプションの) 追加のパラメータによって、
             あいまい検索の程度を指定できます。
             このパラメータの値は 0 から 1 までの間となり、
             1 に近づくほど、類似点が多い単語にのみマッチするようになります。
             たとえば次のように使用します。
+        </para>
 
-            <programlisting language="querystring"><![CDATA[
+        <programlisting language="querystring"><![CDATA[
 roam~0.8
 ]]></programlisting>
 
+        <para>
             このパラメータを省略した場合のデフォルトは 0.5 です。
         </para>
     </sect2>
@@ -246,7 +264,7 @@ roam~0.8
         </para>
 
         <para>
-            そこで、Zend_Search_Lucene はマッチする単語数の制限をクエリ (サブクエリ) 単位で設定します。
+            そこで、<classname>Zend_Search_Lucene</classname> はマッチする単語数の制限をクエリ (サブクエリ) 単位で設定します。
             この制限を取得したり設定したりするには
             <code>Zend_Search_Lucene::getTermsPerQueryLimit()</code>/<code>Zend_Search_Lucene::setTermsPerQueryLimit($limit)</code>
             メソッドを使用します。
@@ -262,12 +280,12 @@ roam~0.8
         <para>
             Lucene は、複数の単語が指定した範囲内にあらわれる状態の検索をサポートしています。
             近接検索を行うには、チルダ記号 "~" をフレーズの最後に指定します。
-            たとえば、"Zend" と "Framework" がお互い 10 ワードの範囲内にあらわれるドキュメントを検索するには
-            <programlisting language="querystring"><![CDATA[
+            たとえば、"Zend" と "Framework" がお互い 10 ワードの範囲内にあらわれるドキュメントを検索するにはこうします。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 "Zend Framework"~10
 ]]></programlisting>
-            とします。
-        </para>
     </sect2>
 
     <sect2 id="zend.search.lucene.query-language.boosting">
@@ -283,19 +301,31 @@ roam~0.8
         <para>
             この機能を使用すると、単語の強調度によってドキュメントの関連性を制御できるようになります。
             たとえば
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 PHP framework
 ]]></programlisting>
+
+        <para>
             を検索しようとしており、単語 "PHP" をより重視したいとしましょう。
             そんな場合は ^ 記号と強調度を単語の後に続けます。つまり
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 PHP^4 framework
 ]]></programlisting>
+
+        <para>
             のようにします。これにより、 <acronym>PHP</acronym> という単語を含むドキュメントがより重視されるようになります。
             フレーズやサブクエリを強調することも可能です。たとえば
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 "PHP framework"^4 "Zend Framework"
 ]]></programlisting>
+
+        <para>
             のようになります。デフォルトの強調度は 1 です。強調度には正の数値を指定しますが、
             1 より小さくする (たとえば 0.2 など) ことも可能です。
         </para>
@@ -330,11 +360,12 @@ PHP^4 framework
             </para>
             <para>
                 "PHP framework" および "Zend Framework" を含むドキュメントを検索するには
-                <programlisting language="querystring"><![CDATA[
+                下記を使用します。
+            </para>
+
+            <programlisting language="querystring"><![CDATA[
 "PHP framework" AND "Zend Framework"
 ]]></programlisting>
-                を使用します。
-            </para>
         </sect3>
 
         <sect3 id="zend.search.lucene.query-language.boolean.or">
@@ -344,11 +375,12 @@ PHP^4 framework
             </para>
             <para>
                 "PHP framework" あるいは "Zend Framework" を含むドキュメントを検索するには
-                <programlisting language="querystring"><![CDATA[
+                下記を使用します。
+            </para>
+
+            <programlisting language="querystring"><![CDATA[
 "PHP framework" OR "Zend Framework"
 ]]></programlisting>
-                を使用します。
-            </para>
         </sect3>
 
         <sect3 id="zend.search.lucene.query-language.boolean.not">
@@ -359,12 +391,13 @@ PHP^4 framework
                 インデックス化されたドキュメント全体ではなく空の結果を返します。
             </para>
             <para>
-                "PHP framework" を含むが "Zend Framework" は含まないドキュメントを検索するには
-                <programlisting language="querystring"><![CDATA[
+                "PHP framework" を含むけれども "Zend Framework" を含まないドキュメントを検索するには
+                下記を使用します。
+            </para>
+
+            <programlisting language="querystring"><![CDATA[
 "PHP framework" AND NOT "Zend Framework"
 ]]></programlisting>
-                を使用します。
-            </para>
         </sect3>
 
         <sect3 id="zend.search.lucene.query-language.boolean.other-form">
@@ -382,11 +415,12 @@ PHP^4 framework
             </para>
             <para>
                 "Zend" を必ず含み、"Framework" を含んでも含まなくてもかまわないドキュメントを検索するには
-                <programlisting language="querystring"><![CDATA[
+                下記を使用します。
+            </para>
+
+            <programlisting language="querystring"><![CDATA[
 +Zend Framework
 ]]></programlisting>
-                を使用します。
-            </para>
         </sect3>
 
         <sect3 id="zend.search.lucene.query-language.boolean.minus">
@@ -396,12 +430,12 @@ PHP^4 framework
                 "-" 記号の後の単語を含むドキュメントを検索結果から除外します。
             </para>
             <para>
-                "PHP framework" は含むが "Zend Framework" は含まないドキュメントを検索するには
+                "PHP framework" を含むけれども "Zend Framework" を含まないドキュメントを検索するには
+                下記を使用します。
+            </para>
                 <programlisting language="querystring"><![CDATA[
 "PHP framework" -"Zend Framework"
 ]]></programlisting>
-                を使用します。
-            </para>
         </sect3>
 
         <sect3 id="zend.search.lucene.query-language.boolean.no-operator">
@@ -420,11 +454,12 @@ PHP^4 framework
             </para>
             <para>
                 "PHP framework" は必須で "Zend Framework" は含んでも含まなくてもかまわないドキュメントを検索するには
-                <programlisting language="querystring"><![CDATA[
+                下記を使用します。
+            </para>
+
+            <programlisting language="querystring"><![CDATA[
 +"PHP framework" "Zend Framework"
 ]]></programlisting>
-                を使用します。
-            </para>
 
             <para>
                 デフォルトの boolean 演算子を設定したり取得したりするには、それぞれ
@@ -446,9 +481,13 @@ PHP^4 framework
             Java Lucene および <classname>Zend_Search_Lucene</classname> では、
             括弧を使用して条件をグループ化することによるサブクエリの作成をサポートしています。
             これは、クエリのロジックを制御したい場合や異なるスタイルの論理クエリを共用したい場合などに便利です。
-            <programlisting language="querystring"><![CDATA[
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 +(framework OR library) +php
 ]]></programlisting>
+
+        <para>
             <classname>Zend_Search_Lucene</classname> は、あらゆるレベルのサブクエリをサポートしています。
         </para>
     </sect2>
@@ -461,11 +500,12 @@ PHP^4 framework
         </para>
         <para>
             タイトルに単語 "return" とフレーズ "pink panther" の両方を含むドキュメントを検索するには
-            <programlisting language="querystring"><![CDATA[
+            下記を使用します。Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 title:(+return +"pink panther")
 ]]></programlisting>
-            を使用します。Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。
-        </para>
     </sect2>
 
     <sect2 id="zend.search.lucene.query-language.escaping">
@@ -483,12 +523,11 @@ title:(+return +"pink panther")
         </para>
         <para>
             これらの文字をエスケープするには、その文字の前に \ をつけます。
-            たとえば、(1+1):2 を検索するには
-            <programlisting language="querystring"><![CDATA[
+            たとえば、(1+1):2 を検索するには下記を使用します。
+        </para>
+
+        <programlisting language="querystring"><![CDATA[
 \(1\+1\)\:2
 ]]></programlisting>
-            を使用します。
-        </para>
     </sect2>
-
 </sect1>

documentation/manual/ja/module_specs/Zend_Service_StrikeIron-AdvancedUses.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21825 -->
+<!-- EN-Revision: 21831 -->
 <sect1 id="zend.service.strikeiron.advanced-uses">
     <title>Zend_Service_StrikeIron: 応用編</title>
 
@@ -25,8 +25,9 @@
         ラッパークラスが存在しない StrikeIron サービスを使用するには、
         <methodname>getService()</methodname> のオプションに
         <code>class</code> ではなく <code>wsdl</code> を指定します。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
 
@@ -40,7 +41,6 @@ echo $result->listingName;
 
 // Zend Technologies USA Inc
 ]]></programlisting>
-      </para>
 
       <para>
         StrikeIron サービスを WSDL から使用するには、
@@ -96,8 +96,9 @@ echo $result->listingName;
         や
         <ulink url="http://www.php.net/manual/ja/function.soap-soapclient-getlastresponse.php"><methodname>__getLastRequest()</methodname></ulink>
         のような適切なメソッドをコールします。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 $strikeIron =
     new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                       'password' => 'あなたのパスワード',
@@ -114,7 +115,5 @@ $soapClient = $taxBasic->getSoapClient();
 echo $soapClient->__getLastRequest();
 echo $soapClient->__getLastResponse();
 ]]></programlisting>
-      </para>
-
     </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Service_StrikeIron-Overview.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 21831 -->
 <sect1 id="zend.service.strikeiron">
     <title>Zend_Service_StrikeIron</title>
 
@@ -158,14 +158,14 @@
         <classname>Zend_Service_StrikeIron</classname> クラスには、
         そのコンストラクタで StrikeIron アカウント情報やその他のオプションを設定できます。
         また、StrikeIron の各種サービス用のクライアントを帰すファクトリメソッドも用意しています。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
 
 $taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));
 ]]></programlisting>
-      </para>
 
       <para>
         <methodname>getService()</methodname> メソッドは、StrikeIron
@@ -193,8 +193,9 @@ $taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));
       <para>
         <methodname>getService()</methodname> で StrikeIron サービス用のクライアントを取得したら、
         あとは普通の <acronym>PHP</acronym> オブジェクトと同様にそのメソッドをコールできます。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
 
@@ -208,6 +209,7 @@ echo $rateInfo->abbreviation;
 echo $rateInfo->GST;
 ]]></programlisting>
 
+      <para>
         上の例では、<methodname>getService()</methodname> メソッドを使用して
         <link linkend="zend.service.strikeiron.bundled-services.sales-use-tax-basic">Sales &amp; Use Tax Basic</link>
         サービス用のクライアントを取得しています。
@@ -251,8 +253,9 @@ echo $rateInfo->GST;
         サービスが返した結果を調べる最も単純な方法は、
         <ulink url="http://www.php.net/print_r">print_r()</ulink>
         のような <acronym>PHP</acronym> の組み込み関数を使うことです。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 <?php
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
@@ -277,7 +280,6 @@ Zend_Service_StrikeIron_Decorator Object
         )
 )
 ]]></programlisting>
-      </para>
 
       <para>
         上の例でわかるように、デコレータ (<code>$rateInfo</code>) が
@@ -324,8 +326,9 @@ Zend_Service_StrikeIron_Decorator Object
         このような場合は例外がスローされます。
         例外が発生することを想定して、
         サービスのメソッドをコールする際には例外処理を書く必要があります。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
 
@@ -342,6 +345,8 @@ try {
 
 }
 ]]></programlisting>
+
+      <para>
         スローされる例外は、常に <classname>Zend_Service_StrikeIron_Exception</classname>
         となります。
       </para>
@@ -381,8 +386,9 @@ try {
         <code>getService</code> メソッドが返す StrikeIron クライアントにはすべて、
         そのサービスの購入状況を調べる
         <methodname>getSubscriptionInfo()</methodname> メソッドが存在します。
+      </para>
 
-        <programlisting language="php"><![CDATA[
+      <programlisting language="php"><![CDATA[
 // Sales & Use Tax Basic サービス用のクライアントを取得します
 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
                                                 'password' => 'あなたのパスワード'));
@@ -393,7 +399,6 @@ $taxBasic = $strikeIron->getService(array('class => 'SalesUseTaxBasic'));
 $subscription = $taxBasic->getSubscriptionInfo();
 echo $subscription->remainingHits;
 ]]></programlisting>
-      </para>
 
       <para>
         <methodname>getSubscriptionInfo()</methodname> メソッドが返すオブジェクトの多くには、

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21815 -->
+<!-- EN-Revision: 21829 -->
 <sect1 id="zend.session.basic_usage">
 
     <title>基本的な使用法</title>
@@ -23,14 +23,16 @@
         <classname>Zend_Session_Namespace</classname> の各インスタンスが、
         スーパーグローバル配列 <code>$_SESSION</code> のエントリに対応します。
         名前空間をキーとして使用します。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $myNamespace = new Zend_Session_Namespace('myNamespace');
 
 // $myNamespace は $_SESSION['myNamespace'] に対応します
 ]]></programlisting>
 
-        Zend_Session は、<code>$_SESSION</code> を直接使用するその他のコードと組み合わせて使用することもできます。
+    <para>
+        <classname>Zend_Session</classname> は、<code>$_SESSION</code> を直接使用するその他のコードと組み合わせて使用することもできます。
         しかし、問題が起こることをさけるために、<code>$_SESSION</code>
         を直接使用するのは <classname>Zend_Session_Namespace</classname>
         のインスタンスに関連しないキーに限るようにしましょう。