sync mainly 21829

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

documentation/manual/ja/module_specs/Zend_Log-Filters.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20792 -->
+<!-- EN-Revision: 22432 -->
 <sect1 id="zend.log.filters">
     <title>フィルタ</title>
 
@@ -14,8 +14,9 @@
         <para>
             すべてのライターの前にフィルタをかけるには、任意の数のフィルタを
             <methodname>addFilter()</methodname> メソッドでログオブジェクトに追加します。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $logger = new Zend_Log();
 
 $writer = new Zend_Log_Writer_Stream('php://output');
@@ -31,6 +32,7 @@ $logger->info('通知メッセージ');
 $logger->emerg('緊急メッセージ');
 ]]></programlisting>
 
+        <para>
             ログオブジェクトにフィルタを追加すると、
             フィルタを全て通過したものだけをライターが受け取るようになります。
         </para>
@@ -41,9 +43,10 @@ $logger->emerg('緊急メッセージ');
 
         <para>
             特定のライターインスタンスに対してだけフィルタをかけるには、ライターの
-            <code>addFilter</code> メソッドを使用します。
+            <methodname>addFilter()</methodname> メソッドを使用します。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $logger = new Zend_Log();
 
 $writer1 = new Zend_Log_Writer_Stream('/path/to/first/logfile');
@@ -62,6 +65,5 @@ $logger->info('通知メッセージ');
 // 両方のライターに記録されます
 $logger->emerg('緊急メッセージ');
 ]]></programlisting>
-        </para>
     </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Log-Formatters.xml

@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21824 -->
+<!-- EN-Revision: 22755 -->
 <sect1 id="zend.log.formatters">
   <title>フォーマッタ</title>
+
   <para>
-    フォーマッタの役割は、<code>event</code> 配列からイベントの内容を受け取り、
+    フォーマッタの役割は、<property>event</property> 配列からイベントの内容を受け取り、
     それを文字列としてフォーマットして出力することです。
   </para>
 
@@ -22,18 +23,19 @@
       <classname>Zend_Log_Formatter_Simple</classname> はデフォルトのフォーマッタです。
       これは、何もフォーマッタを指定しなかった場合に自動的に設定されます。
       デフォルトの設定は、次のようになります。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $format = '%timestamp% %priorityName% (%priority%): %message%' . PHP_EOL;
 $formatter = new Zend_Log_Formatter_Simple($format);
 ]]></programlisting>
-    </para>
 
     <para>
       フォーマッタを個々のライターオブジェクトに対して設定するには、ライターの
       <methodname>setFormatter()</methodname> メソッドを使用します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Stream('php://output');
 $formatter = new Zend_Log_Formatter_Simple('hello %message%' . PHP_EOL);
 $writer->setFormatter($formatter);
@@ -45,13 +47,12 @@ $logger->info('there');
 
 // "hello there" と出力します
 ]]></programlisting>
-    </para>
 
     <para>
       <classname>Zend_Log_Formatter_Simple</classname> のコンストラクタには、
       パラメータとして書式指定文字列を渡すことができます。
       この文字列には、キーをパーセント記号で囲んだもの
-      (例. <code>%message%</code>) を含めます。
+      (例. <command>%message%</command>) を含めます。
       書式指定文字列には、イベントデータの配列の任意のキーを含めることができます。
       デフォルトのキーを取得するには、<classname>Zend_Log_Formatter_Simple</classname>
       の定数 DEFAULT_FORMAT を使用します。
@@ -60,11 +61,13 @@ $logger->info('there');
 
   <sect2 id="zend.log.formatters.xml">
     <title>XML へのフォーマット</title>
+
     <para>
       <classname>Zend_Log_Formatter_Xml</classname> は、ログのデータを <acronym>XML</acronym> 文字列に変換します。
       デフォルトでは、イベントデータ配列のすべての項目を自動的に記録します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Stream('php://output');
 $formatter = new Zend_Log_Formatter_Xml();
 $writer->setFormatter($formatter);
@@ -74,12 +77,12 @@ $logger->addWriter($writer);
 
 $logger->info('通知メッセージ');
 ]]></programlisting>
-    </para>
 
     <para>
       上のコードの出力は、次のような <acronym>XML</acronym> になります (可読性を確保するため空白を補っています)。
+    </para>
 
-      <programlisting language="xml"><![CDATA[
+    <programlisting language="xml"><![CDATA[
 <logEntry>
   <timestamp>2007-04-06T07:24:37-07:00</timestamp>
   <message>通知メッセージ</message>
@@ -87,15 +90,15 @@ $logger->info('通知メッセージ');
   <priorityName>INFO</priorityName>
 </logEntry>
 ]]></programlisting>
-    </para>
 
     <para>
       ルート要素を変更したり、<acronym>XML</acronym> の要素名とイベントデータ配列の項目名の対応を指定したりすることも可能です。
       <classname>Zend_Log_Formatter_Xml</classname> のコンストラクタの最初のパラメータには、
       ルート要素の名前を指定します。また、
       二番目のパラメータには要素名の対応を表す連想配列を指定します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Stream('php://output');
 $formatter = new Zend_Log_Formatter_Xml('log',
                                         array('msg' => 'message',
@@ -109,18 +112,18 @@ $logger->addWriter($writer);
 $logger->info('通知メッセージ');
 ]]></programlisting>
 
+    <para>
       上のコードは、ルート要素の名前をデフォルトの
-      <code>logEntry</code> から <code>log</code> に変更します。また、要素名
-      <code>msg</code> をイベントデータの項目 <code>message</code> に対応させます。
+      <property>logEntry</property> から <property>log</property> に変更します。また、要素名
+      <property>msg</property> をイベントデータの項目 <property>message</property> に対応させます。
       出力結果は次のようになります。
+    </para>
 
-      <programlisting language="xml"><![CDATA[
+    <programlisting language="xml"><![CDATA[
 <log>
   <msg>通知メッセージ</msg>
   <level>INFO</level>
 </log>
 ]]></programlisting>
-    </para>
-
   </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Log-Writers.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 21740 -->
+<!-- EN-Revision: 22756 -->
 <sect1 id="zend.log.writers" xmlns:xi="http://www.w3.org/2001/XInclude">
   <title>ライター</title>
   <para>
@@ -18,31 +18,33 @@
     </para>
 
     <para>
-      ログのデータを <acronym>PHP</acronym> の出力バッファに書き出すには、URL <code>php://output</code>
+      ログのデータを <acronym>PHP</acronym> の出力バッファに書き出すには、URL <filename>php://output</filename>
       を使用します。一方、ログのデータを直接 <constant>STDERR</constant>
-      のようなストリームに送ることもできます (<code>php://stderr</code>)。
+      のようなストリームに送ることもできます (<filename>php://stderr</filename>)。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Stream('php://output');
 $logger = new Zend_Log($writer);
 
 $logger->info('Informational message');
 ]]></programlisting>
-    </para>
 
     <para>
       データをファイルに書き出すには、
       <ulink url="http://www.php.net/manual/ja/wrappers.php#wrappers.file">ファイルシステム
       URL</ulink> のいずれかを使用します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Stream('/path/to/logfile');
 $logger = new Zend_Log($writer);
 
 $logger->info('Informational message');
 ]]></programlisting>
 
-      デフォルトでは、ストリームを追記モード (<code>"a"</code>) でオープンします。
+    <para>
+      デフォルトでは、ストリームを追記モード ("a") でオープンします。
       別のモードでオープンするには、<classname>Zend_Log_Writer_Stream</classname>
       のコンストラクタで二番目のオプション引数にモードを指定します。
     </para>
@@ -50,8 +52,9 @@ $logger->info('Informational message');
     <para>
       <classname>Zend_Log_Writer_Stream</classname> のコンストラクタには、
       既存のストリームリソースを指定することもできます。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $stream = @fopen('/path/to/logfile', 'a', false);
 if (! $stream) {
     throw new Exception('ストリームのオープンに失敗しました');
@@ -63,6 +66,7 @@ $logger = new Zend_Log($writer);
 $logger->info('通知メッセージ');
 ]]></programlisting>
 
+    <para>
       既存のストリームリソースに対してモードを指定することはできません。
       指定しようとすると <classname>Zend_Log_Exception</classname> をスローします。
     </para>
@@ -70,15 +74,16 @@ $logger->info('通知メッセージ');
 
   <sect2 id="zend.log.writers.database">
     <title>データベースへの書き出し</title>
+
     <para>
       <classname>Zend_Log_Writer_Db</classname> は、
       <classname>Zend_Db</classname> を使用してログ情報をデータベースに書き出します。
       <classname>Zend_Log_Writer_Db</classname> のコンストラクタには
       <classname>Zend_Db_Adapter</classname> のインスタンス、テーブル名
       およびデータベースのカラムとイベントデータ項目との対応を指定します。
-      columns to event data items:
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $params = array ('host'     => '127.0.0.1',
                  'username' => 'malory',
                  'password' => '******',
@@ -93,9 +98,10 @@ $logger = new Zend_Log($writer);
 $logger->info('通知メッセージ');
 ]]></programlisting>
 
-      上の例は、一行ぶんのログデータを <code>log_table_name</code>
+    <para>
+      上の例は、一行ぶんのログデータを 'log_table_name'
       という名前のテーブルに書き出します。データベースのカラム
-      <code>lvl</code> には優先度の番号が格納され、<code>msg</code>
+      'lvl' には優先度の番号が格納され、'msg'
       というカラムにログのメッセージが格納されます。
     </para>
 
@@ -110,27 +116,30 @@ $logger->info('通知メッセージ');
 
   <sect2 id="zend.log.writers.null">
     <title>ライターのスタブ</title>
+
     <para>
       <classname>Zend_Log_Writer_Null</classname> はスタブで、ログデータをどこにも書き出しません。
       これは、ログ出力を無効にしたりテスト時などに便利です。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer = new Zend_Log_Writer_Null;
 $logger = new Zend_Log($writer);
 
 // どこにも出力されません
 $logger->info('通知メッセージ');
 ]]></programlisting>
-    </para>
   </sect2>
 
   <sect2 id="zend.log.writers.mock">
     <title>モックによるテスト</title>
+
     <para>
       <classname>Zend_Log_Writer_Mock</classname> は非常にシンプルなライターです。
       受け取った生のデータを配列に格納し、それを public プロパティとして公開します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $mock = new Zend_Log_Writer_Mock;
 $logger = new Zend_Log($mock);
 
@@ -146,10 +155,9 @@ var_dump($mock->events[0]);
 //    [priorityName] => INFO
 // )
 ]]></programlisting>
-    </para>
 
     <para>
-      モックが記録したイベントを消去するには、単純に <code>$mock->events = array()</code>
+      モックが記録したイベントを消去するには、単純に <command>$mock->events = array()</command>
       とします。
     </para>
   </sect2>
@@ -161,8 +169,9 @@ var_dump($mock->events[0]);
       合成ライターオブジェクトはありません。
       しかし、ログのインスタンスは任意の数のライターに書き出すことができます。そのためには
       <methodname>addWriter()</methodname> メソッドを使用します。
+    </para>
 
-      <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 $writer1 = new Zend_Log_Writer_Stream('/path/to/first/logfile');
 $writer2 = new Zend_Log_Writer_Stream('/path/to/second/logfile');
 
@@ -173,6 +182,5 @@ $logger->addWriter($writer2);
 // 両方のライターに書き出されます
 $logger->info('通知メッセージ');
 ]]></programlisting>
-    </para>
   </sect2>
 </sect1>

documentation/manual/ja/module_specs/Zend_Memory-MemoryManager.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20827 -->
+<!-- EN-Revision: 22762 -->
 <sect1 id="zend.memory.memory-manager">
     <title>メモリマネージャ</title>
 
     <sect2 id="zend.memory.memory-manager.creation">
-
         <title>メモリマネージャの作成</title>
 
         <para>
@@ -40,28 +39,27 @@ $memoryManager = Zend_Memory::factory('File', $backendOptions);
 
         <para>
             標準の <classname>Zend_Cache</classname> のバックエンドに加え、特別な名前
-            '<code>None</code>' をバックエンド名として使用することもできます。
+            'None' をバックエンド名として使用することもできます。
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $memoryManager = Zend_Memory::factory('None');
 ]]></programlisting>
-        </para>
 
         <para>
-            バックエンド名に '<code>None</code>' を使用すると、
+            バックエンド名に 'None' を使用すると、
             メモリマネージャは決してメモリブロックをスワップしなくなります。
             メモリの制限がない場合、あるいはオブジェクトのサイズが
             決してメモリの制限に達しない場合などに有用です。
         </para>
 
         <para>
-            '<code>None</code>' バックエンドには何もオプションを指定する必要がありません。
+            'None' バックエンドには何もオプションを指定する必要がありません。
         </para>
 
     </sect2>
 
     <sect2 id="zend.memory.memory-manager.objects-management">
-
         <title>メモリオブジェクトの管理</title>
 
         <para>
@@ -70,19 +68,18 @@ $memoryManager = Zend_Memory::factory('None');
         </para>
 
         <sect3 id="zend.memory.memory-manager.objects-management.movable">
-
             <title>移動可能なオブジェクトの作成</title>
 
             <para>
                 移動可能なオブジェクト (スワップされる可能性のあるオブジェクト)
                 を作成するには、<methodname>Zend_Memory_Manager::create([$data])</methodname>
                 メソッドを使用します。
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 $memObject = $memoryManager->create($data);
 ]]></programlisting>
 
-            </para>
-
             <para>
                 引数 <code>$data</code> は省略可能で、
                 オブジェクトの値を初期化するために使用します。
@@ -92,17 +89,17 @@ $memObject = $memoryManager->create($data);
         </sect3>
 
         <sect3 id="zend.memory.memory-manager.objects-management.locked">
-
             <title>ロックされたオブジェクトの作成</title>
 
             <para>
                 ロックされたオブジェクト (スワップされないオブジェクト)
                 を作成するには、<methodname>Zend_Memory_Manager::createLocked([$data])</methodname>
                 メソッドを使用します。
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 $memObject = $memoryManager->createLocked($data);
 ]]></programlisting>
-            </para>
 
             <para>
                 引数 <code>$data</code> は省略可能で、
@@ -113,14 +110,14 @@ $memObject = $memoryManager->createLocked($data);
         </sect3>
 
         <sect3 id="zend.memory.memory-manager.objects-management.destruction">
-
             <title>オブジェクトの破棄</title>
 
             <para>
                 メモリオブジェクトは、それがスコープの外に出た際に
                 自動的に破棄され、メモリから削除されます。
+            </para>
 
-                <programlisting language="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 function foo()
 {
     global $memoryManager, $memList;
@@ -157,11 +154,9 @@ function foo()
     </sect2>
 
     <sect2 id="zend.memory.memory-manager.settings">
-
         <title>メモリオブジェクトの設定</title>
 
         <sect3 id="zend.memory.memory-manager.settings.memory-limit">
-
             <title>メモリの制限</title>
 
             <para>
@@ -179,27 +174,27 @@ function foo()
                 メモリの制限を取得あるいは設定するには、
                 <methodname>getMemoryLimit()</methodname> メソッドおよび <methodname>setMemoryLimit($newLimit)</methodname>
                 メソッドを使用します。
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 $oldLimit = $memoryManager->getMemoryLimit();  // メモリの制限バイト数を取得します
 $memoryManager->setMemoryLimit($newLimit);     // メモリの制限バイト数を設定します
 ]]></programlisting>
-            </para>
 
             <para>
                 メモリの制限に負の値を設定すると、'制限なし' を意味します。
             </para>
 
             <para>
-                デフォルト値は、php.ini の '<code>memory_limit</code>'
+                デフォルト値は、php.ini の 'memory_limit'
                 の値の三分の二となります。もし php.ini で
-                '<code>memory_limit</code>' が設定されていない場合は、デフォルト値は
+                'memory_limit' が設定されていない場合は、デフォルト値は
                 '制限なし' (-1) となります。
             </para>
 
         </sect3>
 
         <sect3 id="zend.memory.memory-manager.settings.min-size">
-
             <title>MinSize</title>
 
             <para>
@@ -212,18 +207,17 @@ $memoryManager->setMemoryLimit($newLimit);     // メモリの制限バイト数
                 最小サイズを取得あるいは設定するには、
                 <methodname>getMinSize()</methodname> メソッドおよび <methodname>setMinSize($newSize)</methodname>
                 メソッドを使用します。
-                <programlisting language="php"><![CDATA[
+            </para>
+
+            <programlisting language="php"><![CDATA[
 $oldMinSize = $memoryManager->getMinSize();  // MinSize をバイト数で取得します
 $memoryManager->setMinSize($newSize);        // MinSize をバイト数で設定します
 ]]></programlisting>
-            </para>
 
             <para>
                 デフォルト値は 16KB (16384 バイト) です。
             </para>
 
         </sect3>
-
     </sect2>
-
 </sect1>