fixed and clean up.

3 files changed, 45 insertions, 30 deletions

diff --git a/fml/doc/ja/tutorial/message/chapter.sgml b/fml/doc/ja/tutorial/message/chapter.sgml
index 0b7370a7..f1869484 100644
--- a/fml/doc/ja/tutorial/message/chapter.sgml
+++ b/fml/doc/ja/tutorial/message/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.7 2004/10/06 09:07:40 fukachan Exp $
+   $FML: chapter.sgml,v 1.8 2008/08/19 03:16:56 fukachan Exp $
 -->
 
 
@@ -13,9 +13,9 @@
 <link linkend="module.mail.message">
 Mail::Message クラス
 </link>
-のほうを見て下さい。
+を見て下さい。
 このクラスが基本的な操作法を提供しています。
-Mail::Bounce や Mail::Delivery を始め、
+Mail::Bounce や Mail::Delivery をはじめ、
 あらゆる関数がこのクラスに依存しています。
 </para>
 
@@ -27,15 +27,17 @@ Mail::Bounce や Mail::Delivery を始め、
 	</title>
 
 <para>
-メールはヘッダに始まりボディ(メール本文)が続きます。MIME/Multipart の
-ように、ボディは複数の部分(パート)から成ることもありますが、いずれにせ
-よ数珠つなぎ構造です。
+メールはヘッダに始まりボディ(メール本文)が続きます。
+MIME/Multipart のように、
+ボディは複数の部分(パート)から成ることもありますが、
+いずれにせよ数珠つなぎ構造です。
 </para>
 
 <para>
-メールの配送処理だけを考えると、メール本文の細部の構造を気にする必要は
-ありません。一方で、フィルタリングを始めとして、メール本文の解析を必要
-としている処理は多々あります。
+メールの配送処理だけを考えるなら、
+メール本文の細部の構造を気にする必要はありません。
+一方で、フィルタリングをはじめとして、
+メール本文の解析を必要としている処理が多々あります。
 </para>
 
 <para>
@@ -51,7 +53,7 @@ Mail::Bounce や Mail::Delivery を始め、
 </para>
 
 <para>
-例えば、このような使い方をします。
+たとえば、このような使い方をします。
 <screen>
     my $fh  = new FileHandle $file;
     my $msg = Mail::Message->parse( { fd => $fh } );
@@ -99,7 +101,9 @@ Mail::Bounce や Mail::Delivery を始め、
 	</title>
 
 <para>
-これはメールを構築する際に用いるクラスですが、単なるアダプタです。
+これはメール、
+特にコマンドメールの処理を返す場合などの返答
+などを構築する際に用いるクラスですが、単なるアダプタです。
 メールを作成する実体は
 CPAN の MIME::Lite クラスです。
 作成のリクエストは
diff --git a/fml/doc/ja/tutorial/message/discussion.sgml b/fml/doc/ja/tutorial/message/discussion.sgml
index 03a872b9..bb8ea8de 100644
--- a/fml/doc/ja/tutorial/message/discussion.sgml
+++ b/fml/doc/ja/tutorial/message/discussion.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: discussion.sgml,v 1.6 2005/06/25 15:11:35 fukachan Exp $
+   $FML: discussion.sgml,v 1.7 2008/08/19 03:16:56 fukachan Exp $
 -->
 
 
@@ -10,8 +10,13 @@
 
 <para>
 ＭＬドライバは、適宜、エラーメッセージを送信者に返す必要があります。
-そしてエラーメッセージは言語依存です。
-よって、何らかの形で言語変換をしてから送り出す必要があります。
+そしてエラーメッセージは送信者の言語依存でないといけないでしょう。
+</para>
+
+<para>
+よって、
+多国語化対応と適切な文字コード変換をしてから送り出す必要があります。
+そして、そのための処理関数群が必要です。
 </para>
 
 
@@ -26,14 +31,14 @@
 <screen>
    Mesg(*e, キーワード, デフォルトのメッセージ, 変換に使う引数);
 </screen>
-の形で呼び出す関数がありました。
+の形で呼び出すメッセージ処理関数がありました。
 </para>
 
 <para>
 Mesg() は /usr/local/fml/messages/Japanese/ 以下にあるファイル群に対し
 て、キーワード検索を行ないます。各ファイルにはカテゴリごとに分類された
-キーワードとメッセージが定義されています。つまり各ファイルに複数のキー
-ワードが定義されています。
+キーワードとメッセージが定義されています。
+つまり各ファイルに複数のキーワードが定義されています。
 </para>
 
 <para>
@@ -42,6 +47,11 @@ Mesg() は /usr/local/fml/messages/Japanese/ 以下にあるファイル群に対し
 ファイルの not_found という欄が該当します。
 </para>
 
+<para>
+あまり素敵なものではありませんでした。
+といって、locale が素敵というものでもないですなぁ…
+</para>
+
 </sect2>
 
 
@@ -95,8 +105,8 @@ locale の定義ファイル(
 
 <para>
 言語問題の一つは locale に対応するか？という問題です。
-makefml を筆頭に、各種コマンド群のエラーメッセージの日本語化
-を考えると、
+makefml を筆頭に、
+各種コマンド群のエラーメッセージの日本語化を考えると、
 locale を考えておくのも悪くはないのかとも思います。
 この場合は locale ぽくするために
 <screen>
@@ -119,11 +129,11 @@ locale を考えておくのも悪くはないのかとも思います。
 FML::Message::ja::キーワード
 </screen>
 というクラスをじゃんじゃん作るような作り方になるでしょう。
-例えば
+たとえば
 <screen>
 FML::Message::ja::not_found
 </screen>
-などと2、300個のファイルが作られることになります。
+などと 2、300 個のファイルが作られることになります。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/message/language.sgml b/fml/doc/ja/tutorial/message/language.sgml
index 34364ef5..5ef79bc0 100644
--- a/fml/doc/ja/tutorial/message/language.sgml
+++ b/fml/doc/ja/tutorial/message/language.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: language.sgml,v 1.7 2005/06/25 15:11:35 fukachan Exp $
+   $FML: language.sgml,v 1.8 2008/08/19 03:16:56 fukachan Exp $
 -->
 
 
@@ -36,21 +36,22 @@ $curproc->reply_message_nl('error.already_member',
 <screen>
 $_arg_address
 </screen>
-は reply_message_nl の引数のハッシュリファレンスとして与えられた値へ展
-開されます。上の例でいえば、メッセージテンプレート中の $_arg_address 
+は reply_message_nl() 
+の引数のハッシュリファレンスとして与えられた値へ展開されます。
+上の例でいえば、メッセージテンプレート中の $_arg_address 
 が引数中の _arg_address の値で展開されます。
 </para>
 
 <para>
-また config.cf 中で定義されている変数も同様に展開可能です。
-例えばテンプレート中の $ml_name はＭＬ名に展開されるようになっています。
+また config.cf 中で定義されている変数はメッセージ中でも展開可能です。
+たとえばテンプレート中の $ml_name は 
+config.cf 中と同様にＭＬ名に自動展開されます。
 </para>
 
 <para>
-こういったことがあるので、渡す引数に $_arg_ などという prefix をつけて
-いるわけです。つまり、config.cf の変数群とぶつからないようにするため。
+このため、
+つまり config.cf の変数群とぶつからないようにするため、
+渡す引数に $_arg_ などという prefix をつけているわけです。
 </para>
 
 </sect1>
-
-