[DOCUMENTATION]Japanese sync 19421, 19422, 19426, 19440, 19446, 19450

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

documentation/manual/ja/module_specs/Zend_Db_Select.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 19418 -->
+<!-- EN-Revision: 19446 -->
 <sect1 id="zend.db.select">
 
     <title>Zend_Db_Select</title>
@@ -796,12 +796,6 @@ $select = $db->select()
                 クエスチョンマーク ("<code>?</code>") をその値で置き換えます。
             </para>
 
-            <para>
-                このメソッドはパラメータをひとつだけ受け取ります。
-                複数の値を置換する必要がある場合は、文字列を自分でフォーマットし、
-                値の挿入やクォートを自分で行う必要があります。
-            </para>
-
             <example id="zend.db.select.building.where.example-param">
 
                 <title>where() メソッドでのパラメータの例</title>

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

@@ -1,12 +1,47 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17503 -->
+<!-- EN-Revision: 19450 -->
 <sect1 id="zend.mail.additional-headers">
     <title>追加のヘッダ</title>
 
     <para>
-        <methodname>addHeader()</methodname> メソッドを使用して、
-        任意のヘッダを指定することができます。ヘッダフィールドの名前、
+        <classname>Zend_Mail</classname> は追加のメールヘッダを設定するためのメソッドをいくつか提供します。
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <methodname>setReplyTo($email, $name=null)</methodname>: Reply-To: ヘッダを設定します。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>setDate($date = null)</methodname>: Date: ヘッダを設定します。
+                    既定ではこのメソッドは現在のタイムスタンプを使用します。
+                    または、このメソッドにタイムスタンプ、日付文字列または <classname>Zend_Date</classname>
+                    インスタンスを渡せます。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>setMessageId($id = true)</methodname>: Message-Id: ヘッダを設定します。
+                    既定ではこのメソッドは自動的にメッセージ ID を生成できます。
+                    または、このメソッドにメッセージ ID 文字列を渡せます。
+                    このメソッドは内部的に <methodname>createMessageId()</methodname> を呼び出します。
+                </para>
+            </listitem>
+        </itemizedlist>
+     </para>
+    <note>
+        <title>Return-Path</title>
+        <para>
+            もしメールに Return-Path を設定する場合は、<link linkend="zend.mail.introduction.sendmail"
+                >sendmail トランスポートの設定</link>をご覧ください。
+            残念ながら、 <methodname>setReturnPath($email)</methodname> メソッドはこの目的を果たしません。
+        </para>
+    </note>
+
+    <para>
+        さらに、 <methodname>addHeader()</methodname> メソッドを使用して、
+        任意のヘッダを指定できます。ヘッダフィールドの名前、
         そして設定する値の 2 つのパラメータが必須となります。
         3 番目のパラメータはオプションで、ヘッダが複数の値をとるかどうかを指定します。
     </para>
@@ -21,10 +56,6 @@ $mail->addHeader('X-greetingsTo', 'Dad', true);
 ]]></programlisting>
     </example>
 
-    <para>
-        Reply-To: ヘッダを設定するには <methodname>setReplyTo($email, $name=null)</methodname> 関数を使用します。
-        メールアドレスと名前の間にスペースを含むのでさらにエスケープを要するためです。
-    </para>
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 15103 -->
+<!-- EN-Revision: 19422 -->
 <sect1 id="zend.mail.character-sets">
     <title>文字セット</title>
     <para>
@@ -17,6 +17,35 @@
             文字セットが適用されるのは、プレーンテキストのメッセージについてのみです。
         </para>
     </note>
+
+    <example id="zend.mail.character-sets.cjk">
+        <title>CJK 言語での利用</title>
+
+        <para>
+            下記の例は日本語での <classname>Zend_Mail</classname> の使い方です。
+            これは <acronym>CJK</acronym> (別名 <acronym>CJKV</acronym> ) 言語のひとつです。
+            もしあなたが中国語を使うなら、 <acronym>ISO-2022-JP</acronym> の代わりに
+            <acronym>HZ-GB-2312</acronym> を使うでしょう。
+        </para>
+
+        <programlisting language="php"><![CDATA[
+//PHP スクリプト上で文字列の文字エンコードが UTF-8 と仮定します。
+function myConvert($string) {
+    return mb_convert_encoding($string, 'ISO-2022-JP', 'UTF-8');
+}
+
+$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);
+$mail->setHeaderEncoding(Zend_Mime::ENCODING_BASE64);
+$mail->setFrom('somebody@example.com', myConvert('Some Sender'));
+$mail->addTo('somebody_else@example.com', myConvert('Some Recipient'));
+$mail->setSubject(myConvert('TestSubject'));
+$mail->send();
+]]></programlisting>
+
+    </example>
+
 </sect1>
 <!--
 vim:se ts=4 sw=4 et:

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17407 -->
+<!-- EN-Revision: 19421 -->
 <sect1 id="zend.mail.encoding">
     <title>エンコーディング</title>
     <para>
@@ -29,7 +29,7 @@
 
     <programlisting language="php"><![CDATA[
 // デフォルトは Zend_Mime::ENCODING_QUOTEDPRINTABLE です
-$mail = new Zend_Mail('UTF-8');
+$mail = new Zend_Mail();
 
 // Base64 エンコーディングに変更します
 $mail->setHeaderEncoding(Zend_Mime::ENCODING_BASE64);

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18755 -->
+<!-- EN-Revision: 19426 -->
 <sect1 id="zend.mail.multiple-emails">
     <title>SMTP 接続による複数のメールの送信</title>
 
@@ -38,7 +38,7 @@ for ($i = 0; $i < 5; $i++) {
 
     <para>
         各配送ごとに別々の接続を使用したい場合は、
-        <function>send()</function> メソッドのコールの前後に
+        <methodname>send()</methodname> メソッドのコールの前後に
         トランスポートの作成と廃棄をする必要があります。
         あるいは、トランスポートのプロトコルオブジェクトを用いて
         各配送の接続を操作することもできます。

documentation/manual/ja/module_specs/Zend_Mime.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 19440 -->
 <sect1 id="zend.mime.mime">
     <title>Zend_Mime</title>
 
@@ -29,6 +29,11 @@
             </listitem>
             <listitem>
                 <para>
+                    <methodname>Zend_Mime::encode()</methodname>: 指定されたエンコードで文字列を エンコードします。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
                     <methodname>Zend_Mime::encodeBase64()</methodname>: 文字列を base64 でエンコードします。
                 </para>
             </listitem>
@@ -38,6 +43,18 @@
                     文字列を quoted-printable でエンコードします。
                 </para>
             </listitem>
+            <listitem>
+                <para>
+                    <methodname>Zend_Mime::encodeBase64Header()</methodname>:
+                    メールヘッダ用に文字列を base64 でエンコードします。
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <methodname>Zend_Mime::encodeQuotedPrintableHeader()</methodname>:
+                    メールヘッダ用に文字列を quoted-printable でエンコードします。
+                </para>
+            </listitem>
         </itemizedlist>
     </para>
     <para>
@@ -88,6 +105,21 @@
                     <constant>Zend_Mime::DISPOSITION_INLINE</constant>: 'inline'
                 </para>
             </listitem>
+            <listitem>
+                <para>
+                    <constant>Zend_Mime::MULTIPART_ALTERNATIVE</constant>: 'multipart/alternative'
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <constant>Zend_Mime::MULTIPART_MIXED</constant>: 'multipart/mixed'
+                </para>
+            </listitem>
+            <listitem>
+                <para>
+                    <constant>Zend_Mime::MULTIPART_RELATED</constant>: 'multipart/related'
+                </para>
+            </listitem>
         </itemizedlist>
     </para>
     </sect2>

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 18786 -->
+<!-- EN-Revision: 19426 -->
 <sect1 id="zend.translate.adapter">
 
     <title>Zend_Translate のアダプタ</title>
@@ -204,8 +204,8 @@
                 <title>PHP 5.3 でのリグレッション</title>
 
                 <para>
-                    <acronym>PHP</acronym> 5.3 より前のバージョンでは、<function>parse_ini_file()</function> および
-                    <function>parse_ini_string()</function> で
+                    <acronym>PHP</acronym> 5.3 より前のバージョンでは、<methodname>parse_ini_file()</methodname>
+                    および <methodname>parse_ini_string()</methodname> で
                     <acronym>INI</acronym> オプションのキーに非 ASCII 文字を問題なく使用できました。
                     しかし <acronym>PHP</acronym> 5.3 以降では、
                     非 ASCII 文字のキーはどちらの関数の返す配列からも黙って抜け落ちてしまいます。