overhaul

17 files changed, 220 insertions, 97 deletions

diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml
index d9553482..bde207d1 100644
--- a/fml/doc/ja/tutorial/delivery/chapter.sgml
+++ b/fml/doc/ja/tutorial/delivery/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.15 2005/11/19 03:45:06 fukachan Exp $
+   $FML: chapter.sgml,v 1.16 2006/01/17 04:46:03 fukachan Exp $
 -->
 
 
@@ -15,9 +15,13 @@
 	</title>
 
 <para>
-&fml8; の最大の目的の一つは、メンバーリストの取得操作におけるコー
-ドの統合と抽象化です。配送には抽象化された Mail::Delivery クラスを次の
-ように使います。
+&fml8; の最大の目的の一つは、メンバーリストの取得操作におけるコードの
+統合と抽象化です。もちろん配送システムも抽象化された IO 層を利用して配
+送先の情報を取得しています。
+</para>
+
+<para>
+配送には抽象化された Mail::Delivery クラスを次のように使っています。
 </para>
 
 <para>
@@ -26,9 +30,7 @@ Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ
 つまり
 Mail::Delivery は
 Mail::Delivery 以下の派生クラス
-SMTP
-ESMTP
-LMTP
+SMTP、ESMTP
 へのインターフェイスを提供するアダプター層です。
 </para>
 
diff --git a/fml/doc/ja/tutorial/delivery/queue.sgml b/fml/doc/ja/tutorial/delivery/queue.sgml
index 18335ba4..df71af35 100644
--- a/fml/doc/ja/tutorial/delivery/queue.sgml
+++ b/fml/doc/ja/tutorial/delivery/queue.sgml
@@ -1,5 +1,5 @@
 <!--
-    $FML: queue.sgml,v 1.7 2004/10/06 09:07:35 fukachan Exp $
+    $FML: queue.sgml,v 1.8 2005/06/25 15:11:30 fukachan Exp $
 -->
 
 
@@ -27,6 +27,14 @@ exit(75) です。このエラーコードをうけとると、MTA は一時的なエラーがお
 </para>
 
 <para>
+失敗が一時的なディスク溢れ(file system full)なら、MTA の再送処理でリト
+ライが行なわれＭＬの処理が行なわれます。
+ただ、ＭＬのスプールに用意したファイルシステムでのディスク溢れ(file
+system full)が一時的とは考えにくいので、システム管理者が気づかないと、
+ずっとエラーになり続ける可能性が高いと思います。
+</para>
+
+<para>
 incoming queue の処理は Mail::Delivery::Queue を使い、ＭＬ固有の queue 
 で管理されます。一連の処理が終ると、たいてい、そのプロセスの最後に、
 このキューは消されます。
@@ -52,13 +60,13 @@ FML::Process::QueueManager
 <para>
 微妙に処理が異なりますが、記事の配送もコマンドメールも同様に
 Mail::Delivery::Queue ベースのキューイング処理をしています。そのため、
-配送処理の途中でエラーが起きた場合、別のfmlプロセスにより再送処理が行
-なわれます。
+配送処理の途中でエラーが起きた場合、別の &fml8; プロセスにより再送処理
+が行なわれます。
 </para>
 
 <sect2>
 	<title>
-	fml の中では、どう書くのか？
+	&fml8; の中では、どう書くのか？
 	</title>
 
 <para>
@@ -67,7 +75,7 @@ Mail::Delivery::Queue ベースのキューイング処理をしています。そのため、
 $curproc->reply_message( "you are not a ML member." );
 </screen>
 この場合の受信者はコマンドの結果などを受けとる人、
-fml にリクエストをした人です。
+&fml8; にリクエストをした人です。
 </para>
 
 
@@ -146,8 +154,10 @@ deferred/
 info/sender/
 info/recipients/
 info/transport/
+isolated/
 </screen>
 info/ には envelope 情報が格納されます。
+isolated/ は隔離された不正なメール（ほぼ 100 % SPAM)置場です。
 また incoming/ は incoming queue ですが、それ以外のディレクトリは
 outgoing 用です。
 </para>
diff --git a/fml/doc/ja/tutorial/delivery/recipes.forward.sgml b/fml/doc/ja/tutorial/delivery/recipes.forward.sgml
index 84c9e8c5..8b30eccd 100644
--- a/fml/doc/ja/tutorial/delivery/recipes.forward.sgml
+++ b/fml/doc/ja/tutorial/delivery/recipes.forward.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: recipe.forward.sgml,v 1.3 2004/10/06 09:07:35 fukachan Exp $
+   $FML: recipes.forward.sgml,v 1.1 2006/01/17 04:46:03 fukachan Exp $
 -->
 
 
@@ -26,7 +26,7 @@ if (条件 A にマッチした) {
    $config->set('recipient_maps', "recipients.A");
 }
 </screen>
-のようなコードを書けば動きます。
+のようなコード(hook)を書けば動きます。
 </para>
 </answer>
 
diff --git a/fml/doc/ja/tutorial/devel/create_program.sgml b/fml/doc/ja/tutorial/devel/create_program.sgml
index 5601f131..e4bf79f5 100644
--- a/fml/doc/ja/tutorial/devel/create_program.sgml
+++ b/fml/doc/ja/tutorial/devel/create_program.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: create_program.sgml,v 1.9 2004/10/06 09:07:35 fukachan Exp $
+   $FML: create_program.sgml,v 1.10 2005/06/25 15:11:30 fukachan Exp $
 -->
 
 
@@ -99,7 +99,7 @@ lrwxr-xr-x  1 root  wheel     6 Apr 14 18:25 mead@ -> loader
 <para>
 デフォルトのプログラムについては、インストーラがこれらの symlink 処理
 をしてくれています。インストーラに symlink (後述)を実行してもらう必要
-があるなら、etc/install.cf.in のbin_programs か libexec_programs にプ
+があるなら、etc/install.cf.in の bin_programs か libexec_programs にプ
 ログラム名を定義して下さい。テスト段階では手動で symlink を行なってか
 まいません。
 </para>
@@ -173,7 +173,7 @@ run_cgi_options()
 これらの組で一つの画面
 <footnote>
 <para>
-正確には画面は３×３の合計９個のブロックからなりますが、
+正確には、画面は３×３の合計９個のブロックからなりますが、
 そのうちの６つしか使っていません。
 </para>
 </footnote>
diff --git a/fml/doc/ja/tutorial/digest/chapter.sgml b/fml/doc/ja/tutorial/digest/chapter.sgml
index 9d75d9b1..fb120cac 100644
--- a/fml/doc/ja/tutorial/digest/chapter.sgml
+++ b/fml/doc/ja/tutorial/digest/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.7 2005/10/08 07:30:07 fukachan Exp $
+   $FML: chapter.sgml,v 1.8 2005/11/19 03:45:06 fukachan Exp $
 -->
 
 
@@ -48,8 +48,8 @@ recipients-digest が、まとめおくりの配送リストです。
 </para>
 
 <para>
-$digest_recipient_maps は、もちろん IO::Adapter なので、
-mysql なども利用可能です。
+もちろん IO::Adapter クラスを利用して配送リストを取得するので、
+$digest_recipient_maps では mysql なども利用可能です。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/digest/recipes.sgml b/fml/doc/ja/tutorial/digest/recipes.sgml
index 557cc118..f919fbcb 100644
--- a/fml/doc/ja/tutorial/digest/recipes.sgml
+++ b/fml/doc/ja/tutorial/digest/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML$
+ $FML: recipes.sgml,v 1.1 2005/10/08 03:37:42 fukachan Exp $
 -->
 
 <qandaset>
@@ -16,7 +16,6 @@
 <answer>
 <para>
 いつでもかまいません。
-crontab を適当に書き換えて下さい。
 </para>
 </answer>
 
@@ -33,6 +32,7 @@ crontab を適当に書き換えて下さい。
 
 <answer>
 <para>
+できません。
 現在は MIME/Multipart しかサポートしていないので、
 変更ということがそもそもありえません。
 </para>
@@ -51,6 +51,7 @@ makefml add の時にまとめ送りパラメータも指定したい
 
 <answer>
 <para>
+できません。
 現在は MIME/Multipart しかサポートしていないので、
 まとめ送りパラメータの指定ということがそもそもありえません。
 </para>
@@ -63,7 +64,7 @@ makefml add の時にまとめ送りパラメータも指定したい
 
 <question>
 <para>
-まとめ送りのログを別ファイルに記録したい 
+まとめ送りのログ”だけ”を別ファイルに記録したい 
 </para>
 </question>
 
diff --git a/fml/doc/ja/tutorial/install/download.sgml b/fml/doc/ja/tutorial/install/download.sgml
index 9e47fe90..b70b576c 100644
--- a/fml/doc/ja/tutorial/install/download.sgml
+++ b/fml/doc/ja/tutorial/install/download.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: download.sgml,v 1.4 2004/10/06 09:07:36 fukachan Exp $
+   $FML: download.sgml,v 1.5 2008/08/07 01:03:16 fukachan Exp $
 -->
 
 
@@ -25,10 +25,20 @@
 
 <para>
 開発の適当な区切りごとに、不定期に作成されています。
+現在のファイル名は
+<screen>
+fml-VERSION-DATA.tar.gz
+</screen>
+形です。
+VERSION は 8.0 正式リリース以前なのでなので 8.0 より少し小さい値
+7.98.x などとなっています。
 ファイル名に日付が入っていますので、
 日付の新しいものを選んでダウンロードして下さい。
 </para>
 
+<!--
+	XXX-TODO: daily snapshots
+
 <para>
 なお daily snapshot もあります。
 全自動で作られているので、特定の日のバージョンはうまく動かないかも知れ
@@ -40,6 +50,7 @@
 ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/
 </ulink>
 </para>
+-->
 
 </sect1>
 
diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
index 4a30a41b..b53527dd 100644
--- a/fml/doc/ja/tutorial/install/fml_on_unix.sgml
+++ b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
@@ -1,11 +1,11 @@
 <!--
-   $FML: fml_on_unix.sgml,v 1.11 2005/10/08 07:32:54 fukachan Exp $
+   $FML: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
 -->
 
 
 <chapter id="install.fml.unix">
 	<title>
-	UNIX 上での fml のインストール
+	Unix 上での fml のインストール
 	</title>
 
 
@@ -64,10 +64,10 @@ make install を実行すると、configure が生成した etc/fml/install.cf を
 fml では各ディレクトリにさらに /fml といった suffix をつけます。
 変更できるのは、その直前の prefix 部分までです。
 <screen>
-変数            configure のデフォルト値    fml の利用するディレクトリ
+変数            configure のデフォルト値    fml の利用するディレクトリ例
 --------------------------------------------------------
 prefix          /usr/local                  /usr/local
-exec_prefix     /usr/local
+exec_prefix     /usr/local                  /usr/local
 bindir          ${exec_prefix}/bin          /usr/local/bin
 sbindir         ${exec_prefix}/sbin         /usr/local/sbin
 libexecdir      ${exec_prefix}/libexec      /usr/local/libexec/fml
@@ -114,7 +114,7 @@ configure --help
 	</title>
 
 <para>
-例: NetBSD は /usr/pkg 以下だね 
+例: NetBSD は /usr/pkg 以下へ。
 <screen>
 % ./configure --prefix=/usr/pkg
 </screen>
@@ -398,7 +398,7 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
 デフォルトでは &fml4; と合わせるために、および見本として:)
 subject のタグをつけない設定とフィルタ関連の設定だけが入っています。
 <screen>
-# $FML: fml_on_unix.sgml,v 1.11 2005/10/08 07:32:54 fukachan Exp $
+# $FML: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
 #
 #               site default_config.cf EXAMPLE
 #
@@ -483,6 +483,20 @@ use_mime_component_filter	=	yes
 をカスタマイズしてください。
 </para>
 
+<warning>
+<para>
+ただ、仕事のメールで添付ファイルなしは厳しいようなので、
+社内向けメールなど仕事用のＭＬサーバとして使うなら、
+インストール後、すぐに
+<screen>
+[/usr/local/etc/fml/site_default_config.cf]
+
+use_mime_component_filter	=	no
+</screen>
+に変更しておくとよいでしょう。
+</para>
+</warning>
+
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/install/postfix.sgml b/fml/doc/ja/tutorial/install/postfix.sgml
index de698a30..d3b2f122 100644
--- a/fml/doc/ja/tutorial/install/postfix.sgml
+++ b/fml/doc/ja/tutorial/install/postfix.sgml
@@ -1,18 +1,45 @@
 <!--
-   $FML: postfix.sgml,v 1.5 2004/10/06 09:07:37 fukachan Exp $
+   $FML: postfix.sgml,v 1.6 2005/06/25 15:11:32 fukachan Exp $
 -->
 
 
 <sect1 id="install.postfix">
 	<title>
-	メールサーバの設定 (postfix)
+	メールサーバの設定 (Postfix)
 	</title>
 
 <para>
-makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
-め postfix の設定を変更しておいて下さい。
+makefml newml を実行するだけでＭＬが自動的に有効になるように、
+次のように Postfix の設定を変更して下さい。
 </para>
 
+<caution>
+<para>
+一つのドメインについては、一度 Postfix の設定をすれば、あとは makefml 
+ないしは fml コマンドの操作だけでＭＬの作成、削除が可能になりますが、
+別のドメインを使うなら、ドメインごとに Postfix の alias_maps と 
+virtual_maps の追加設定が必要になることに注意して下さい。
+</para>
+
+
+</caution>
+
+
+<sect2>
+	<title>
+	Postfix からプログラムを実行可能にする。	
+	</title>
+
+<para>
+<screen>
+allow_mail_to_commands = alias,forward,include
+</screen>
+の設定を入れて下さい。
+これはＭＬドライバを実行するためにどんなケースでも必須の設定です。
+</para>
+
+</sect2>
+
 
 <sect2>
 	<title>
@@ -23,13 +50,29 @@ makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
 <para>
 具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。
 <screen>
+# Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
 alias_maps	=	hash:/etc/mail/aliases
 			hash:/var/spool/ml/etc/mail/aliases
 </screen>
+hash:/var/spool/ml/etc/mail/aliases は 
+「デフォルトのＭＬスプール/etc/mail/aliases」です。
+CUI で newml コマンドを実行すると、画面上で
+hash:/var/spool/ml/etc/mail/aliases 
+ファイルをアップデートしていることが表示されるのでパスを確認してみて下
+さい。
+newml コマンドの使い方についての詳細は
+<link linkend="install.fml.unix">
+<xref linkend="install.fml.unix">
+</link>
+の章を参照。
 </para>
 
+<!--
+XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
+-->
+
 <warning>
 <para>
 また mydestination にデフォルトのドメイン(おそらく $mydomain )が
@@ -49,6 +92,7 @@ alias_maps	=	hash:/etc/mail/aliases
 /etc/postfix/main.cf で
 alias_maps と virtual_maps の両方に設定の追加が必要です。
 <screen>
+# Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
 alias_maps	=	hash:/etc/mail/aliases
@@ -62,27 +106,37 @@ makefml newml を実行すると
 /var/spool/nuinui.net/etc/mail/aliases
 および
 /var/spool/nuinui.net/etc/postfix/virtual 
-は makefml によって自動的に更新されます。
-なお、この場合、ml_home_prefix_maps で
+は makefml によって自動的に更新されます(画面に表示されるので分かるはず)。
+なお、この場合、事前に ml_home_prefix_maps で
 <screen>
 nuinui.net /var/spool/nuinui.net
 </screen>
 という「ドメイン←→ディレクトリ」の定義がなされています。
+newml コマンドの使い方についての詳細は
+<link linkend="install.fml.unix">
+<xref linkend="install.fml.unix">
+</link>
+の章を参照。
 </para>
 
+<!--
+XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
+-->
+
 <warning>
 
 <para>
 &fml8; が作る virtual_maps のファイルは Postfix スタイルの 
 virtual_maps です。最近の Postfix には sendmail スタイルというのもあり
-ますが、ここでは昔からある postfix スタイルを使っているということに注
-意して下さい。
+ますが、&fml8; では昔からある postfix スタイルを使っているということに
+注意して下さい。
 </para>
 
 <para>
-mydestination にデフォルトのドメイン(おそらく $mydomain)がちゃんと追加
-されていることを確認して下さい。しかし、バーチャルドメイン(ここでは 
-nuinui.net)は mydestination に追加する必要はありません。注意して下さい。
+mydestination には、デフォルトのドメイン(おそらく $mydomain)を入れるこ
+とが普通ですが、バーチャルドメイン(ここでは nuinui.net)は 
+mydestination に追加する必要はありません(Postfix は virtual_maps の値
+を見て mydestination 相当であるとみなしています)。注意して下さい。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/install/recipes.sgml b/fml/doc/ja/tutorial/install/recipes.sgml
index 4c85f0ea..00b5550e 100644
--- a/fml/doc/ja/tutorial/install/recipes.sgml
+++ b/fml/doc/ja/tutorial/install/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML$
+ $FML: recipes.sgml,v 1.1 2005/10/08 07:32:54 fukachan Exp $
 -->
 
 <qandaset>
@@ -50,8 +50,7 @@ procmail の利用を考えてみて下さい。
 </para>
 
 <para>
-ダウンロードからインストールまで全てユーザ root で行なってもよいでしょ
-う。
+ダウンロードからインストールまで全てユーザ root で行なっても問題ありません。
 </para>
 </answer>
 
@@ -119,7 +118,7 @@ jperl で fml を使いたい
 
 <question>
 <para>
-elena ML を上書きしたい
+elena ML を上書き(再生成)したい
 </para>
 </question>
 
@@ -145,10 +144,10 @@ elena ML を上書きしたい
 
 <answer>
 <para>
-はい、編集してもかまいませんが内容は自分で管理するようにして下さい。本
-来そこは makefml/fml が自動で編集するところですので、ＭＬを消せば削除
-されますし、削除後にＭＬ復活を行なっても元には戻りませんので注意して下
-さい。
+はい、編集してもかまいませんが内容は自分で管理するようにして下さい。
+ただ、本来そこは makefml/fml が自動で編集するところですので、ＭＬを消
+せば削除されますし、削除後にＭＬ復活を行なっても元には戻りませんので、
+注意して下さい。
 </para>
 </answer>
 
@@ -181,7 +180,7 @@ MTA を Unix で動かせば良いでしょう。
 
 <question>
 <para>
-ML を初期化したい
+ＭＬを初期化(再初期化)したい
 </para>
 </question>
 
@@ -198,4 +197,20 @@ ML を初期化したい
 </qandaentry>
 
 
+<qandaentry>
+<question>
+	<para>
+	間違えて rmml してしまったＭＬを復活させたい
+	</para>
+</question>
+
+<answer>
+	<para>
+	reviveml コマンドを使って下さい。
+	</para>
+</answer>
+</qandaentry>
+
+
+
 </qandaset>
diff --git a/fml/doc/ja/tutorial/install/upgrade.sgml b/fml/doc/ja/tutorial/install/upgrade.sgml
index e5ca9a12..a9c67b1c 100644
--- a/fml/doc/ja/tutorial/install/upgrade.sgml
+++ b/fml/doc/ja/tutorial/install/upgrade.sgml
@@ -1,22 +1,22 @@
 <!--
-   $FML: upgrade.sgml,v 1.7 2004/10/06 09:07:37 fukachan Exp $
+   $FML: upgrade.sgml,v 1.8 2005/06/25 15:11:33 fukachan Exp $
 -->
 
 
 <chapter id="xxxgrade">
 	<title>
-	fml8 のアップグレード/ダウングレード
+	&fml8; のアップグレード/ダウングレード
 	</title>
 
 <warning>
 
 <para>
-本章では fml8 のバージョンをアップグレード/ダウングレードする方法につ
+本章では &fml8; のバージョンをアップグレード/ダウングレードする方法につ
 いて解説します。
 </para>
 
 <para>
-fml4 から fml8 へのアップグレードは、
+&fml4; から &fml8; へのアップグレードは、
 <link linkend="mergeml.fml4to8">
 <xref linkend="mergeml.fml4to8">
 </link>
@@ -28,12 +28,18 @@ fml4 から fml8 へのアップグレードは、
 
 <sect1 id="upgrade">
 	<title>
-	fml8 のアップグレード
+	&fml8; のアップグレード
 	</title>
 
+<warning>
 <para>
 インストールするだけでは何も変化は起こりません。
-まずは、単に、もう一度 fml8 を
+main.cf を編集した瞬間にアップグレードが有効になります。
+</para>
+</warning>
+
+<para>
+まずは、単に、もう一度 &fml8; を
 <link linkend="install.fml.unix">
 インストール
 </link>
@@ -43,7 +49,7 @@ fml4 から fml8 へのアップグレードは、
 <para>
 そして、インストール後、/usr/local/etc/fml/main.cf の fml_version 行を
 今インストールしたバージョンに変更して下さい。
-ファイルをセーブした瞬間から新しい fml8 に切り替わります
+ファイルをセーブした瞬間から新しい &fml8; に切り替わります
 (注: エディタで編集中は古い内容)。
 </para>
 
@@ -56,7 +62,7 @@ fml4 から fml8 へのアップグレードは、
 
 <sect1 id="downgrade">
 	<title>
-	fml8 のダウングレード
+	&fml8; のダウングレード
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml
index 823261b6..5d71d328 100644
--- a/fml/doc/ja/tutorial/internals/bootloader.sgml
+++ b/fml/doc/ja/tutorial/internals/bootloader.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: bootloader.sgml,v 1.12 2004/10/06 09:07:37 fukachan Exp $
+   $FML: bootloader.sgml,v 1.13 2005/06/25 15:11:33 fukachan Exp $
 -->
 
 
@@ -120,7 +120,7 @@ FML::Process::Mead       >-|    |
 	/usr/local/etc/fml/main.cf を読み込む。
 	読み込むと fml のバージョンが分かる。
 	main.cf の値から @INC を再設定しバージョン依存性を解決します。
-	default_config.cf はバージョン依存ですので、
+	default_config.cf.{ja,en} はバージョン依存ですので、
 	設定ファイルを読み込む前に、
 	この段階でバージョンを評価しなければいけないことに注意してください。
 	</para>
@@ -156,7 +156,7 @@ FML::Process::Mead       >-|    |
 		<para>
 		(ポリモーフィズムの例)
 		モジュールをダイナミックバインディングし、
-		該当するプロセスオブジェクトを生成する。
+		該当するプロセスオブジェクトを生成、
 		そして、プロセスをスタートさせます。
 
 		FML::Process::Flow の中に、
@@ -169,7 +169,7 @@ $process->verify_request($args);
 $process->run($args);
 $process->finish($args);
 </screen>
-		のように実行されています。
+		のような実行順です。
 		各プロセスは、それぞれについて適当なメソッドを
 		FML::Process:: 以下に用意する必要があります。
 		</para>
diff --git a/fml/doc/ja/tutorial/internals/config.cf.sgml b/fml/doc/ja/tutorial/internals/config.cf.sgml
index 4ecbafc8..b89f4749 100644
--- a/fml/doc/ja/tutorial/internals/config.cf.sgml
+++ b/fml/doc/ja/tutorial/internals/config.cf.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: config.cf.sgml,v 1.14 2005/06/25 15:11:33 fukachan Exp $
+   $FML: config.cf.sgml,v 1.15 2005/12/15 03:08:11 fukachan Exp $
 -->
 
 
@@ -17,7 +17,7 @@
 
 <para>
 各ＭＬごとにさまざまなカスタマイズをすることができます。
-この点は &fml4; でも &fmldevel; でも同様です。
+この点は &fml4; でも &fml8; でも同様です。
 </para>
 
 <para>
@@ -27,7 +27,7 @@
 </para>
 
 <para>
-一方 &fmldevel; では config.cf というファイルです。
+一方 &fml8; では config.cf というファイルです。
 フォーマットは postfix や .ini 風の
 <screen>
 変数 = 値
@@ -64,7 +64,7 @@ cf というファイルと config.ph という
 <para>
 しかし、これはこれで２つのファイルに分かれてしまう点が
 保守しにくさを生みます。
-よって &fmldevel; では、
+よって &fml8; では、
 設定インターフェイスにやさしい新フォーマットを提唱します。
 それが config.cf です。
 これは本質的に postfix 風のフォーマットです。
@@ -198,7 +198,7 @@ x = a b c d e
 <para>
 fml は起動時にそれらのファイルを順番に読みこみ、
 最後にＭＬ固有の config.cf を読み込みます。
-そして、その後に変数の展開処理を行ないます。
+そして、すべてのファイルを読み込んだ後に変数の展開処理を行ないます。
 </para>
 
 </sect1>
@@ -292,11 +292,8 @@ config.cf 内で使って良い関数はどれですか？
 <answer>
 
 <para>
-「$curproc のメソッド」です。
-</para>
-
-<para>
-フックで使える関数の話であることに注意して下さい。
+つまり、フックで利用可能な関数は何ですか？ということになりますが、
+それは「$curproc のメソッド」です。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/internals/db_modules.sgml b/fml/doc/ja/tutorial/internals/db_modules.sgml
index f262af5c..200e7eb2 100644
--- a/fml/doc/ja/tutorial/internals/db_modules.sgml
+++ b/fml/doc/ja/tutorial/internals/db_modules.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: db_modules.sgml,v 1.2 2004/10/06 09:07:38 fukachan Exp $
+   $FML: db_modules.sgml,v 1.3 2005/06/25 15:11:33 fukachan Exp $
 -->
 
 <!--
@@ -51,8 +51,12 @@ FML::Cache::Ring のいづれかが使われることとなっています。
 
 <para>
 なお、メンバーリストなどの永続性の必要なデータに対するデータベースはき
-ちんと DBMS (データベース管理システム)を使うべきです。ここで述べている
-データベースは fml8 が動作する上で内部的に使っているデータベースです。
+ちんと DBMS (データベース管理システム)を使うべきです。
+</para>
+
+<para>
+本章で述べるデータベースは 
+&fml8; が動作する上で内部的に使っているデータベースのことです。
 </para>
 
 </sect1>
@@ -68,8 +72,8 @@ FML::Cache::Ring のいづれかが使われることとなっています。
 面目なものまでいろいろです。大真面目に考えると、LRU などの機能を持った
 モジュールを利用して作るのかもしれませんが、やや大げさで、いまひとつしっ
 くりこない気がします。つまり、そこまで真面目に virtual memory のような
-実装をしなくてもよいのでは？という気がします。それに、もし切実に必要な
-ら、なんらかの
+実装をしなくてもよいのでは？ということです。それに、もし切実な必要があ
+るのなら、なんらかの
 <link linkend="dbms">
 DBMS
 </link>
@@ -82,7 +86,7 @@ DBMS
 </para>
 
 <para>
-ここでは fml8 内部で使っているモジュールの話をします。
+ここでは &fml8; 内部で使っているモジュールの話をします。
 </para>
 
 <para>
@@ -110,8 +114,8 @@ DBMS
 
 
 <para>
-このクラスは、データを追加もするし参照もしたい場合に用いられますが、
-追加のオペレーションしか行なえません。
+このクラスは、データを追加する場合にも使われていますし、過去のデータを
+参照したい場合にも用いられますが、追加のオペレーションしか行なえません。
 つまり LFS (Log Structured File System) のような振舞いです。
 </para>
 
@@ -123,7 +127,8 @@ DBMS
 
 
 <para>
-逆に、必要な場合には、過去のログを追跡していくことができます。
+逆に、それ以上の情報が必要な場合には、過去のログを追跡していくことがで
+きます。
 </para>
 
 
@@ -132,7 +137,7 @@ DBMS
 に対して使います。例えば、登録時の confirmation のキャッシュや
 message-id キャッシュです。これらは expire を時間で制御したいからです。
 このクラスは引数でファイル名を与えることになっているので、ファイル名に
-日付付のファイルを選ぶと良いでしょう。
+日付つきのファイルを選ぶと良いでしょう。
 </para>
 
 
@@ -145,7 +150,7 @@ key => [
 	ろぐ3	 (どっかのふぁいるのどっかの行),
 ]
 </screen>
-型のデータとりだしをしたい場合があります。
+型のデータ取り出しをしたい場合があります。
 この形のデータ取り出しは
 get_all_values_as_hash_ref()
 メソッドを使えば可能です。
@@ -154,7 +159,7 @@ get_all_values_as_hash_ref()
 
 <warning>
 <para>
-なお検索時の挙動のfirst match と last match は切替えることができます。
+なお検索時の挙動の first match と last match は切替えることができます。
 どちらの戦略で探すのか、クラスオブジェクトを生成する際に明示的に指定す
 ることが推奨されます。デフォルトは last match です(最後に書き込んだデー
 タが返される振舞いが自然です)。
@@ -189,7 +194,7 @@ get_all_values_as_hash_ref()
 <para>
 このクラスは、あるディレクトリ(例: db/)の有限の複数のファイル群の中に
 データを蓄えます。
-例えば db/ に 1 〜 100 の名前のファイルがつくられ、
+例えば db/ ディレクトリに 1 〜 100 の名前のファイルがつくられ、
 順番に使われてきます。
 これらのファイルはぐるぐる回って使われ、上書きされます。
 </para>
diff --git a/fml/doc/ja/tutorial/internals/dbms.sgml b/fml/doc/ja/tutorial/internals/dbms.sgml
index dfb627e0..162943d6 100644
--- a/fml/doc/ja/tutorial/internals/dbms.sgml
+++ b/fml/doc/ja/tutorial/internals/dbms.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: dbms.sgml,v 1.6 2004/10/06 09:07:38 fukachan Exp $
+   $FML: dbms.sgml,v 1.7 2005/06/25 15:11:34 fukachan Exp $
 -->
 
 
@@ -12,7 +12,7 @@
 メンバーリストなどの永続性の必要なデータに対しデータベースを用いたいな
 ら、きちんと DBMS (データベース管理システム)を使うべきです。ここで述べ
 ているデータベースとは、そういった意味合いのデータを相手にしています。
-一方 fml8 が動作する上で内部的に使うデータベースモジュールについては
+一方 &fml8; が動作する上で内部的に使うデータベースモジュールについては
 <link linkend="db.module">
 <xref linkend="db.module">
 </link>
diff --git a/fml/doc/ja/tutorial/internals/directory.sgml b/fml/doc/ja/tutorial/internals/directory.sgml
index 6816b370..b0cb0756 100644
--- a/fml/doc/ja/tutorial/internals/directory.sgml
+++ b/fml/doc/ja/tutorial/internals/directory.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: directory.sgml,v 1.6 2005/06/25 15:11:34 fukachan Exp $
+   $FML: directory.sgml,v 1.7 2005/11/29 14:05:11 fukachan Exp $
 -->
 
 
@@ -82,7 +82,7 @@ HTML 化されたファイルをおくサブディレクトリを 1000 ごとに用意すると、
 
 $_xxx_hook = q{
 	my $config = $curproc->config();
-	my $xxxdir = $config->{ some_where_dir };
+	my $xxxdir = $config->get('some_where_dir');
 
 	... 略 ...
 }
diff --git a/fml/doc/ja/tutorial/internals/errormail.sgml b/fml/doc/ja/tutorial/internals/errormail.sgml
index 1c24abca..503286e0 100644
--- a/fml/doc/ja/tutorial/internals/errormail.sgml
+++ b/fml/doc/ja/tutorial/internals/errormail.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: errormail.sgml,v 1.6 2004/10/06 09:07:39 fukachan Exp $
+   $FML: errormail.sgml,v 1.7 2005/06/25 14:43:08 fukachan Exp $
 -->
 
 
@@ -15,12 +15,12 @@ libexec/error は &fml4; の libexec/mead に相当するものです。
 <para>
 $use_error_mail_analyzer_function を yes にすると、エラー解析機能が有効にな
 ります。ちなみに、デフォルトで $use_error_mail_analyzer_function は yes つま
-りエラー解析機能は有効になっています。このへんは &fml4; と異なります。
+りエラー解析機能は有効になっています。このあたりは &fml4; と異なります。
 </para>
 
 <para>
 つまるところ、
-&fml8; では &fml4; でよく使う機能は始めから有効になっています。
+&fml8; では &fml4; でよく使う機能は初めから有効になっています。
 </para>
 
 
@@ -35,8 +35,8 @@ $use_error_mail_analyzer_function を yes にすると、エラー解析機能が有効にな
 </para>
 
 <para>
-distribute などと同様に libexec/error は標準入力からメールを読みこみ、
-それを解析し、Mail::Message オブジェクトの鎖を作ります。そして、
+libexec/distribute などと同様に libexec/error は標準入力からメールを読
+みこみ、それを解析し、Mail::Message オブジェクトの鎖を作ります。そして、
 Mail::Bounce クラスがエラー内容の解析をします。
 </para>
 
@@ -100,8 +100,12 @@ $error_mail_analyzer_function_select_list にある関数名が利用し得るアル
 </para>
 
 <para>
+デメリット:
 少なくとも一日一通は流量がないと、このアルゴリズムは動作しません。
-よって、ちょっと間違えただけの受信者が削除されることはありません。
+</para>
+
+<para>
+メリット: ちょっと間違えただけの受信者が削除されることはありません。
 </para>
 
 <para>
@@ -109,8 +113,8 @@ $error_mail_analyzer_function_select_list にある関数名が利用し得るアル
 </para>
 
 <para>
-注意: とうぜんのことながら、流量が一日一通に満たないような、まったりと
-したＭＬでは、このアルゴリズムは動作しません:-)
+注意: 当然のことながら、流量が一日一通に満たないような、まったりとした
+ＭＬでは、このアルゴリズムは動作しません:-)
 </para>
 
 </sect2>
@@ -161,6 +165,10 @@ $maintainer_recipient_maps
 message/rfc822 一通だけの無味乾燥な mime/multipart です。
 </para>
 
+<!--
+   XXX-TODO: ヘッダ情報 + そのエラーメールのアドレスの分析レポート
+-->
+
 <para>
 そのうち、ヘッダ情報 + そのエラーメールのアドレスの分析レポートとか
 なんか付けてやれや〜とかちょっと思っています。