overhaul

9 files changed, 71 insertions, 68 deletions

diff --git a/fml/doc/ja/tutorial/internals/filter.sgml b/fml/doc/ja/tutorial/internals/filter.sgml
index 0117b0a5..beb50c4b 100644
--- a/fml/doc/ja/tutorial/internals/filter.sgml
+++ b/fml/doc/ja/tutorial/internals/filter.sgml
@@ -1,10 +1,11 @@
 <!--
-   $FML: filter.sgml,v 1.8 2004/10/06 09:07:39 fukachan Exp $
+   $FML: filter.sgml,v 1.9 2005/06/25 15:11:34 fukachan Exp $
 -->
 
 
 <!--
-   XXX-TODO: かきなおせよ、ふぃるた
+   XXX-TODO: フィルタの説明を書き直せ
+   XXX-TODO: MTI の説明？
 -->
 
 
@@ -93,10 +94,10 @@ text/plain に対してより厳しいシンタックスチェックを行なうフィルタも
 <para>
 変数名体系の基本は以下の通りです。
 <screen>
-use_サービス_filter       = yes
+use_サービス_filter       = yes か no
 サービス_filter_functions = 機能A 機能B
 
-use_機能A   = yes
+use_機能A   = yes か no
 機能A_rules = ルール1 ルール2
 </screen>
 </para>
@@ -190,9 +191,9 @@ text/plain 		:size>500k	cutoff
 	</title>
 
 <para>
-アクションには first match のものとそうでないものがある。reject は た
-いてい first match ですが、cutoff は first match ではないとおもわれま
-す。さて？
+アクションには first match のものとそうでないものがあります。reject は 
+大抵 first match ですが、cutoff は first match ではないとおもわれます。
+さて？
 </para>
 
 </sect2>
@@ -216,7 +217,7 @@ text/plain + image/jpeg + text/html
 <para>
 結論をいえば、cutoff や reject を指定するタイプのルールしかうまく機能
 しない、つまり「特定の○○を削除ないしは拒否する」ことならうまくできる
-といえそうです。ゆえにデフォルトは permit にするしかありません。
+と言えそうです。ゆえにデフォルトは permit にするしかありません。
 </para>
 
 <para>
@@ -278,7 +279,7 @@ multipart/mixed		image/*		cutoff
 
 <para>
 暗黙のデフォルトルールは、他の header や text フィルタとの整合性を考え
-ると、「とりあえず通す」ですかね？
+ると「とりあえず通す」ですかね？
 <screen>
 *		*	permit
 </screen>
@@ -440,7 +441,7 @@ text/plain + text/plain + text/plain
 text/plain + text/plain + image/jpeg
 text/plain + text/plain + text/html
 </screen>
-どれも OK だが、ルールのマッチする場所が異なります。
+どれも OK ですが、ルールのマッチする場所が異なります。
 </para>
 
 </sect2>
diff --git a/fml/doc/ja/tutorial/internals/hook.sgml b/fml/doc/ja/tutorial/internals/hook.sgml
index f683df07..00914acf 100644
--- a/fml/doc/ja/tutorial/internals/hook.sgml
+++ b/fml/doc/ja/tutorial/internals/hook.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: hook.sgml,v 1.6 2004/10/06 09:07:39 fukachan Exp $
+   $FML: hook.sgml,v 1.7 2006/01/16 10:24:27 fukachan Exp $
 -->
 
 
@@ -15,13 +15,13 @@
 	</title>
 
 <para>
-hook は微妙な修正、もしくは複雑なカスタマイズのために是非必要です。
+HOOK は微妙な修正、もしくは複雑なカスタマイズのために是非必要です。
 ですが、実装においてはいくつかの問題があります。
 </para>
 
 <para>
 まず、&fml4; の $START_HOOK のような曖昧なものではなく、
-hook の名前に一定の基準が必要でしょう。
+HOOK の名前に一定の基準が必要でしょう。
 そのため &fml8; では、ある関数の最初と最後にHOOKを用意する場合、
 次のようなスタイルの HOOK 名称になっています。
 <screen>
@@ -58,7 +58,7 @@ HOOK の内容
 </para>
 
 <para>
-&fml4; と &fml8; の大きなちがいのひとつは変数、関数のスコープです。
+&fml4; と &fml8; の大きな違いのひとつは変数、関数のスコープです。
 &fml4; はグローバルなので、どんな関数でも使えますが、&fml8; では、そう
 はいきません。とはいえ、まったく手がかりがないのも困るので、$curproc 
 が使えるような場所にのみ HOOK を用意するといったルールが必要でしょう。
@@ -70,11 +70,11 @@ HOOK の内容
 
 <sect1 id="hook.naming.convention">
 	<title>
-	hook の命名規則
+	HOOK の命名規則
 	</title>
 
 <para>
-hook 名前の標準的な形式については
+HOOK 名前の標準的な形式については
 <screen>
 役割名_メソッド名_start_hook
 役割名_メソッド名_end_hook
diff --git a/fml/doc/ja/tutorial/internals/io_abstraction.sgml b/fml/doc/ja/tutorial/internals/io_abstraction.sgml
index 12ccb233..88c15e98 100644
--- a/fml/doc/ja/tutorial/internals/io_abstraction.sgml
+++ b/fml/doc/ja/tutorial/internals/io_abstraction.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: io_abstraction.sgml,v 1.4 2004/10/06 09:07:39 fukachan Exp $
+   $FML: io_abstraction.sgml,v 1.5 2005/06/25 15:11:34 fukachan Exp $
 -->
 
 
@@ -43,7 +43,7 @@ IO に使われるクラスの各メソッドです。たとえば、IO::Adapter はユーザリ
 	</title>
 
 <para>
-&fmldevel; 全体の基調となる型は 
+&fml8; 全体の基調となる型は 
 <link linkend="module.io.adapter">
 IO::Adapter
 </link>
diff --git a/fml/doc/ja/tutorial/internals/language.sgml b/fml/doc/ja/tutorial/internals/language.sgml
index b9c61eec..eb8160cf 100644
--- a/fml/doc/ja/tutorial/internals/language.sgml
+++ b/fml/doc/ja/tutorial/internals/language.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: language.sgml,v 1.2 2004/04/07 11:07:08 fukachan Exp $
+   $FML: language.sgml,v 1.3 2004/10/06 09:07:39 fukachan Exp $
 -->
 
 
@@ -17,15 +17,15 @@
 <para>
 一番単純なモデルは「このＭＬは日本人用と設定しているなら、メッセージは
 常に日本語で返す」というものです。このモデルでは、ＭＬ作成時に何言語用
-かを指定する必要があります。また、間違って(日本語が読めない人から)送ら
-れてきたメールに対しても、日本語でエラーを返します。
+かを指定する必要があります。しかしながら、間違って(日本語が読めない人
+から)送られてきたメールに対しても、日本語でエラーを返します。
 </para>
 
 <para>
-しかしながら、日本人だからといって、今、メールを読んでいる環境で日本語
-が使えないかも知れないし、Accept-Language: を無視するのもよろしくあり
-ません。とはいえ、みんながちゃんとAccept-Language:をつけているわけでは
-ないので、問題はいろいろと山積みです。
+一方、日本人だからといって、今、メールを読んでいる環境で日本語が使えな
+いかも知れないし、Accept-Language: を無視するのもよろしくありません。
+とはいえ、みんながちゃんとAccept-Language:をつけているわけではないので、
+問題はいろいろと山積みです。
 </para>
 
 <para>
@@ -104,7 +104,7 @@ language_preference_order	=	ja en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: では charset=iso-2022-jp
+	Accept-Language: は無し、Content-Type: では charset=iso-2022-jp
 	</title>
 
 <para>
@@ -116,7 +116,7 @@ language_preference_order	=	ja en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: では charset=us-ascii
+	Accept-Language: は無し、Content-Type: では charset=us-ascii
 	</title>
 
 <para>
@@ -129,7 +129,7 @@ language_preference_order	=	ja en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: もなし
+	Accept-Language: は無し、Content-Type: も無し
 	</title>
 
 <para>
@@ -183,7 +183,7 @@ language_preference_order	=	en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: では charset=iso-2022-jp
+	Accept-Language: は無し、Content-Type: では charset=iso-2022-jp
 	</title>
 
 <para>
@@ -195,7 +195,7 @@ language_preference_order	=	en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: では charset=us-ascii
+	Accept-Language: は無し、Content-Type: では charset=us-ascii
 	</title>
 
 <para>
@@ -207,7 +207,7 @@ language_preference_order	=	en
 
 <sect2>
 	<title>
-	Accept-Language: はなし、Content-Type: もなし
+	Accept-Language: は無し、Content-Type: も無し
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/internals/lock.sgml b/fml/doc/ja/tutorial/internals/lock.sgml
index f02d3baf..5a377696 100644
--- a/fml/doc/ja/tutorial/internals/lock.sgml
+++ b/fml/doc/ja/tutorial/internals/lock.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: lock.sgml,v 1.4 2004/10/06 09:07:39 fukachan Exp $
+   $FML: lock.sgml,v 1.5 2005/06/25 15:11:34 fukachan Exp $
 -->
 
 
@@ -9,8 +9,9 @@
 	</title>
 
 <para>
-プロセス間の同期化はロックを用いて行ないます。fml8 でサポートされてい
-るロックメカニズムは flock(2) or lockf(2) を元にしたロック機構のみです。
+プロセス間の同期化はロックを用いて行ないます。&fml8; でサポートされて
+いるロックメカニズムは flock(2) もしくは lockf(2) を元にしたロック機構
+のみです。
 </para>
 
 
diff --git a/fml/doc/ja/tutorial/internals/main.cf.sgml b/fml/doc/ja/tutorial/internals/main.cf.sgml
index 7e645b64..03aec42e 100644
--- a/fml/doc/ja/tutorial/internals/main.cf.sgml
+++ b/fml/doc/ja/tutorial/internals/main.cf.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: main.cf.sgml,v 1.9 2004/04/07 11:07:08 fukachan Exp $
+   $FML: main.cf.sgml,v 1.10 2004/10/06 09:07:39 fukachan Exp $
 -->
 
 
@@ -11,8 +11,9 @@
 <para>
 /usr/local/etc/fml/main.cf は各ＭＬの設定ではありません。fml のバージョ
 ンなどメタレベルの依存性を解決するための設定ファイルで、fml のプログラ
-ム群が起動する時に参照します。また、main.cf には ディレクトリやプロセ
-スのユーザの指定など最も基本的な情報のみが書かれています。
+ム群が起動する時に参照します。
+main.cf はディレクトリやプロセスのユーザの指定など最も基本的な情報のみ
+が書かれているファイルです。
 </para>
 
 <para>
@@ -30,7 +31,7 @@ main.cf のフォーマットは他の .cf と同様
 
 <screen>
 #
-# $FML: main.cf.sgml,v 1.9 2004/04/07 11:07:08 fukachan Exp $
+# $FML: main.cf.sgml,v 1.10 2004/10/06 09:07:39 fukachan Exp $
 #
 
 # fml version
diff --git a/fml/doc/ja/tutorial/internals/merge.sgml b/fml/doc/ja/tutorial/internals/merge.sgml
index b8059e1f..3d053fc5 100644
--- a/fml/doc/ja/tutorial/internals/merge.sgml
+++ b/fml/doc/ja/tutorial/internals/merge.sgml
@@ -1,17 +1,17 @@
 <!--
-   $FML: merge.sgml,v 1.2 2004/10/06 09:07:40 fukachan Exp $
+   $FML: merge.sgml,v 1.3 2005/06/25 15:11:34 fukachan Exp $
 -->
 
 
 <chapter id="merge.internal.to.fml8">
 	<title>
-	他のＭＬシステムの設定を fml8 へ変換する処理について
+	他のＭＬシステムの設定を &fml8; へ変換する処理について
 	</title>
 
 
 <sect1 id="merge.internal.fml4to8">
 	<title>
-	内部実装: fml 4.0 から fml 8.0 への移行について
+	内部実装: &fml4; から &fml8; への移行について
 	</title>
 
 <sect2>
@@ -24,21 +24,21 @@
 </para>
 
 <para>
-1) fml8 をインストールする。この際、postfix の alias_maps に 
+1) &fml8; をインストールする。この際、postfix の alias_maps に 
 /var/spool/ml/etc/mail/aliases (まだ、この段階では中身のないファイルで
 よい)を追加する。
 </para>
 
 <para>
-2) makefml --force newml elena 相当の処理を行なう。いろいろ fml8 で必
-要なファイルを作る必要があるので、newml を実行してしまうほうがよい。本
-当に makefml newml を実行するか、newml の実体の処理を呼び出すようにす
-るかはどっちでもよい。たぶん後者でよい。
+2) makefml --force newml elena 相当の処理を行なう。&fml8; で必要なファ
+イルをいろいろと作る必要があるので、newml を実行してしまうほうがよい。
+本当に makefml newml を実行するか、newml の実体の処理を呼び出すように
+するかはどっちでもよい。たぶん後者でよい。
 </para>
 
 <para>
-3) /var/spool/ml/elena のメンバーリストを fml8 形式へ変換する。
-その際に、いろいろ変換しないといけない。
+3) /var/spool/ml/elena のメンバーリストを &fml8; 形式へ変換する。
+その際にも、いろいろ変換しないといけない。
 </para>
 
 <para>
@@ -57,14 +57,14 @@ off を s=skip と書いていると on 扱いになってしまう。
 3-3)
 m=... つまりまとめ行が無効になる。
 
-しかしながら、歴史的に members で # address とかされていると
-4.0 では OK だが、8.0 ではこのアドレスは見えない(認証する際の
-候補にならない)。フォーマットを検査して warning を出すべきだろうか？
+しかしながら、歴史的に members で # address と書かれていると 4.0 では 
+OK だが、8.0 ではこのアドレスは見えない(認証する際の候補にならない)。
+フォーマットを検査して warning を出すべきだろうか？
 </para>
 
 <para>
-4) fml4 の aliases ファイル (/var/spool/ml/etc/fml/aliases) から該当す
-るＭＬの部分を消して .db を再生成する。
+4) &fml4; の aliases ファイル (/var/spool/ml/etc/fml/aliases) から該当
+するＭＬの部分を消して .db を再生成する。
 </para>
 
 </sect2>
@@ -76,11 +76,11 @@ m=... つまりまとめ行が無効になる。
 	</title>
 
 <para>
-ケース1を繰り返し、適用すればいいでしょう。
+ケース 1. を繰り返し適用すればいいでしょう。
 </para>
 
 <para>
-移行作業中にＭＬ全体を止めていいなら、fml4 の 
+移行作業中にＭＬ全体を止めていいなら、&fml4; の 
 /var/spool/ml/etc/fml/aliases を削除してからケース１を適用する方が楽で
 すね。もちろん、移行作業中は MTA を止めてください。
 </para>
@@ -90,7 +90,7 @@ m=... つまりまとめ行が無効になる。
 
 <sect2>
 	<title>
-	議論: 同一ドメインで、fml4 と fml8 を半々に使っている場合
+	議論: 同一ドメインで、&fml4; と &fml8; を半々に使っている場合
 	</title>
 
 <para>
@@ -98,18 +98,18 @@ m=... つまりまとめ行が無効になる。
 </para>
 
 <para>
-同一ドメインで、fml4 と fml8 を半々に使っている場合、
+同一ドメインで、&fml4; と &fml8; を半々に使っている場合、
 次のような設定を施しておくとよい？
 いや中途半端なトリックはやめて、
 すなおに、mergeml で変換するか、しないかにしておいた方が無難だと思う。
 </para>
 
 <para>
-fml4での設定(site_init.phとかconfig.ph)で
+&fml4; での設定(site_init.phとかconfig.ph)で
 <screen>
 push(@ACTIVE_LIST,"$DIR/recipients") if( -f "$DIR/recipients" ) ;
 </screen>
-一方、fml8での設定(site_default_config.cfやconfig.cf)で
+一方、&fml8; での設定(site_default_config.cfやconfig.cf)で
 <screen>
 html_archive_dir = $ml_home_dir/htdocs
 </screen>
diff --git a/fml/doc/ja/tutorial/internals/recipes.hook.sgml b/fml/doc/ja/tutorial/internals/recipes.hook.sgml
index 4923d573..b3b6c6eb 100644
--- a/fml/doc/ja/tutorial/internals/recipes.hook.sgml
+++ b/fml/doc/ja/tutorial/internals/recipes.hook.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML$
+   $FML: recipes.hook.sgml,v 1.1 2006/01/16 10:24:27 fukachan Exp $
 -->
 
 
@@ -7,7 +7,7 @@
 
 <question>
 <para>
-HOOK で使うべきおすすめの変数名はなんですか？
+HOOK 内で推奨される変数名は？
 </para>
 </question>
 
@@ -47,9 +47,9 @@ $config オブジェクトへの代入操作は問題ありません。
 </para>
 
 <para>
-理屈の上では HOOK で $curproc 経由でアクセスできる全てのものを変更して
-好きなように &fml8; を操作することが出来ますが、アップグレードなどの保
-証は一切ありません。
+HOOK では $curproc のメソッドでアクセス可能な内容は全て変更して好きな
+ように &fml8; を操作することが出来ますが、それ以外のことをするとアップ
+グレードしても動作する保証は一切ありません。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/internals/restriction.sgml b/fml/doc/ja/tutorial/internals/restriction.sgml
index e212ebd5..ee0107c7 100644
--- a/fml/doc/ja/tutorial/internals/restriction.sgml
+++ b/fml/doc/ja/tutorial/internals/restriction.sgml
@@ -1,11 +1,11 @@
 <!--
-   $FML: restriction.sgml,v 1.9 2005/06/25 15:11:35 fukachan Exp $
+   $FML: restriction.sgml,v 1.10 2005/08/03 13:45:11 fukachan Exp $
 -->
 
 
 <chapter id="restriction">
 	<title>
-	入力データへの制限
+	入力データの検査
 	</title>
 
 <para>
@@ -16,7 +16,7 @@
 
 <sect1 id="restriction.overview">
 	<title>
-	入力の検査についての概要
+	入力データ検査についての概要
 	</title>
 
 <sect2>
@@ -47,7 +47,7 @@
 <para>
 コマンドメールは FML::Process::Command の中で一行ずつ
 FML::Restriction::Command で定義されている正規表現にしたがって
-入浴されたコマンド列が検査されます。検査に合格すれば、
+入力されたコマンド列が検査されます。検査に合格すれば、
 FML::Command::{User,Admin}::コマンド の実行に進むことができます。
 </para>