reorder, enrich part II

2 files changed, 221 insertions, 0 deletions

diff --git a/fml/doc/ja/tutorial/message/chapter.sgml b/fml/doc/ja/tutorial/message/chapter.sgml
new file mode 100644
index 00000000..86de2a7a
--- /dev/null
+++ b/fml/doc/ja/tutorial/message/chapter.sgml
@@ -0,0 +1,108 @@
+<!--
+	$FML: message.sgml,v 1.7 2001/10/13 08:47:57 fukachan Exp $	
+-->
+
+<chapter id="mail.manipulation">
+   <title> メッセージ(メール)の操作 </title>
+
+<para>
+メール(オブジェクト)を扱う関数の詳細については
+<link linkend="module.mail.message">
+Mail::Message クラス
+</link>
+を見て下さい。
+このクラスが基本的な操作法を提供しています。
+Mail::Bounce や Mail::Delivery を始め、
+あらゆる関数がこのクラスに依存しています。
+</para>
+
+
+<!-- ======================================= -->
+<sect1>
+   <title> Mail::Message クラス </title>
+
+<para>
+メールはヘッダに始まりボディ(メール本文)が続きます。
+multipart のように、
+ボディは複数の部分(パート)から成ることもあります。
+</para>
+
+<para>
+メールの配送処理だけを考えると、
+メール本文の細部の構造を気にする必要はありません。
+一方、フィルタリングを始めとして、メール本文の解析を
+必要としている処理は多々あります。
+</para>
+
+<para>
+それらのモジュールのために 
+<link linkend="module.mail.message">
+Mail::Message クラス
+</link>
+があり、
+メールの構造を表現するために用いられています。
+このクラスは
+Mail::Bounce や Mail::Delivery を始め、
+いたるところで使われています。
+</para>
+
+<para>
+例えば、このような使い方をします。
+<screen>
+    my $fh  = new FileHandle $file;
+    my $msg = Mail::Message->parse( { fd => $fh } );
+
+    use FML::Mailer;
+    my $obj = new FML::Mailer;
+    $obj->send( {
+	sender    => $sender,
+	recipient => $rcpt,
+	message   => $msg,
+    });
+</screen>
+</para>
+
+</sect1>
+
+
+<!-- ======================================= -->
+<sect1>
+   <title> Mail::Message::Parse クラス </title>
+
+<para>
+ダミーの派生クラスです。
+これは Mail::Message::Compose と同様の階層を便宜上作っています。
+あまり深い意味はありません。
+</para>
+
+<para>
+パーサの実体は 
+	<link linkend="module.mail.message">
+	Mail::Message
+	</link>
+クラスの中にあります。
+</para>
+
+</sect1>
+
+
+<!-- ======================================= -->
+<sect1>
+   <title> Mail::Message::Compose クラス </title>
+
+<para>
+これはメールを構築する際に用いるクラスですが、単なるアダプタです。
+メールを作成する実体は 
+CPAN の MIME::Lite クラスです。
+作成のリクエストは
+MIME::Lite クラスへ
+丸投げされています。
+</para>
+
+<para>
+使い方やメソッドについての詳細は MIME::Lite クラスを参照して下さい。
+</para>
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/message/reply.sgml b/fml/doc/ja/tutorial/message/reply.sgml
new file mode 100644
index 00000000..5bfd8611
--- /dev/null
+++ b/fml/doc/ja/tutorial/message/reply.sgml
@@ -0,0 +1,113 @@
+<!--
+    $FML: reply.sgml,v 1.4 2001/10/13 08:47:55 fukachan Exp $
+-->
+
+<chapter id="message.reply">
+	<TITLE>
+	fml からメールで返事を送り返す
+	</TITLE>
+
+<sect1>
+   <title> 概要  </title>
+
+<para>
+送り返すべきメールは
+Mail::Delivery::Queue
+を使い queue に入れます。
+queue に入ったメールは、のちに
+FML::Process::QueueManager
+クラスが(配送)処理をします。
+FML::Process::QueueManager により
+queue ファイルが queue ディレクトリから pickup され、
+Mail::Message で parse され、
+FML::Mailer 経由で
+Mail::Delivery が実際にメール配送処理をします。
+<screen>
+Mail::Delivery::Queue
+   ↓
+   ↓→→→ キューディレクトリ
+   ↓
+FML::Process::QueueManager
+   ↓
+   ↓←←← キューディレクトリ
+   ↓
+FML::Mailer
+   ↓
+Mail::Delivery
+</screen>
+</para>
+</sect1>
+
+
+<sect1>
+   <title> queue ディレクトリ  </title>
+
+<para>
+queue ディレクトリは複数のディレクトリからなります。 
+<screen>
+new/
+active/
+deferred/
+info/sender/
+info/recipients/
+</screen>
+info/ には envelope 情報が格納されます。
+</para>
+
+<para>
+queue ファイルを作る時は、一旦 new/ に作成されます。
+queue ファイルを作る作業が終了し、配送準備 OK となったら
+new/ から active/ に移動されます。
+つまり active/ にあるファイルは配送準備ができているものです。
+</para>
+
+<sect2>
+   <title> queue ディレクトリをロックする </title>
+<para>
+特定の $queue_id object ごとに lock() と unlock() メソッドを使い、
+ロックをかけます。
+ロックは active/$queue_id ファイルに対しての flock(2) システムコールです。
+</para>
+</sect2>
+
+</sect1>
+
+
+<sect1>
+	<title>
+	fml の中でどうするか？
+	</title>
+
+<para>
+あるメッセージを送り返したい場合は、次のようにします。
+<screen>
+$curproc->reply_message( "you are not a ML member." );
+</screen>
+この場合の受信者はコマンドの結果などを受けとる人、
+fml にリクエストをした人です。
+</para>
+
+
+<para>
+ファイルを送りたい場合や画像を送りたい場合は次のようにします。
+<screen>
+$curproc->reply_message( {
+        type        => "text/plain; charset=iso-2022-jp",
+        path        => "/etc/fml/main.cf",
+        filename    => "main.cf",
+        disposition => "main.cf example",
+    });
+
+$curproc->reply_message( {
+        type        => "image/gif",
+        path        => "/some/where/logo001.gif",
+        filename    => "logo.gif",
+        disposition => "attachment",
+    });
+</screen>
+</para>
+
+</sect1>
+
+
+</chapter>