clean up / fixed.

8 files changed, 65 insertions, 32 deletions

diff --git a/fml/doc/ja/tutorial/customize/autoreply.sgml b/fml/doc/ja/tutorial/customize/autoreply.sgml
index 06f97866..d1846df8 100644
--- a/fml/doc/ja/tutorial/customize/autoreply.sgml
+++ b/fml/doc/ja/tutorial/customize/autoreply.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: autoreply.sgml,v 1.3 2004/04/07 11:07:01 fukachan Exp $
+   $FML: autoreply.sgml,v 1.4 2004/10/06 09:07:34 fukachan Exp $
 -->
 
 
@@ -40,7 +40,8 @@ $distribute_run_start_hook = q{
 $curproc->stop_this_process();
 </screen>
 が &fml4; の $DO_NOTHING 変数にあたりますが、&fml8; ではメソッドです。
-これで、このHOOK以降、正常の処理が無視されるようになります。 
+これで、この HOOK 以降、正常の処理が無視されるようになります。
+つまり、なにも実行されなくなるというわけです。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/customize/case_studies.sgml b/fml/doc/ja/tutorial/customize/case_studies.sgml
index 5fecba0b..e8ca4868 100644
--- a/fml/doc/ja/tutorial/customize/case_studies.sgml
+++ b/fml/doc/ja/tutorial/customize/case_studies.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: case_studies.sgml,v 1.6 2004/04/07 11:07:01 fukachan Exp $
+   $FML: case_studies.sgml,v 1.7 2004/10/06 09:07:34 fukachan Exp $
 -->
 
 
@@ -14,34 +14,39 @@
 </para>
 
 <para>
-ヘッダ関連では、まず Subject: にタグをつけないことにしました。
+ヘッダ関連では、まず Subject: にタグをつけない
 <footnote>
 <para>
 なお、この設定はデフォルトの site_default_config.cf に仕込まれています。
 つまり &fml8; のデフォルトです。
 </para>
 </footnote>
-ことにした。
+ことにしました。
 <screen>
 article_header_rewrite_rules	-=	rewrite_article_subject_tag
 </screen>
+この例は「ヘッダ書換えのルール」から「タグをつける」命令を抜く設定です。
 </para>
 
 <para>
 そして、X-ML-Name: 部分の mlname にオフィス名をつける(prepend する)、
-つまり mlname から office#mlname へ変更します。
+つまり mlname から office#mlname へ変更するようにします。
 <screen>
-# office#$mlname
 outgoing_mail_header_x_ml_name          =       office#$ml_name
 </screen>
 </para>
 
 <para>
 記事は誰でも投稿可能としましょう。
-ここでは root さんからのシステムメールなども許しています。
 <screen>
 article_post_restrictions		=	permit_anyone
 </screen>
+この例では root さんからのシステムメールなども許していることに注意して
+ください( root などは弾きたい場合 reject_system_accounts permit_anyone 
+です)。
+</para>
+
+<para>
 そして、社内用途のＭＬなので、フィルタの多くは使いません。
 つぅか、使うと問題だらけのようです;)
 <screen>
@@ -70,8 +75,8 @@ use_command_mail_function	=	no
 コマンドメールそのものを禁止するには、aliases から該当するエントリを省
 くことが確実ですが、ＭＬを作成するたびに、aliases から削除することはミ
 ス操作を誘い易いでしょう。また、CGI 操作の場合、CGI 操作者が aliases 
-の操作をするのはおかしいです。そこで、コマンドメール用のプログラムが一
-度は起動しても、すぐ終るという設定にしているわけです。
+の細かな操作をするのは難しいです。そこで、コマンドメール用のプログラム
+が一度は起動しても、すぐ終るという設定にしているわけです。
 </para>
 
 </sect1>
@@ -97,7 +102,7 @@ support@example.co.jp ＭＬでは
 <screen>
 Subject: (SUPPORT 10000)
 </screen>
-などとなるわけです。
+などとするわけです。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/customize/chapter.command.sgml b/fml/doc/ja/tutorial/customize/chapter.command.sgml
index ea0d974a..0006d130 100644
--- a/fml/doc/ja/tutorial/customize/chapter.command.sgml
+++ b/fml/doc/ja/tutorial/customize/chapter.command.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.command.sgml,v 1.2 2004/04/07 11:07:02 fukachan Exp $
+   $FML: chapter.command.sgml,v 1.3 2004/10/06 09:07:34 fukachan Exp $
 -->
 
 
@@ -19,9 +19,9 @@ elena ＭＬに独自の help コマンドを作ることを考えます。
 </para>
 
 <para>
-独自のモジュール help.pm を用意して、ＭＬローカルのライブラリパスへお
-くだけです。オリジナルの help.pm を参考にして、独自の help.pm を作り、
-以下のパスにおいてください。
+独自の help コマンドは、独自のモジュール help.pm を用意して、ＭＬロー
+カルのライブラリパスへおくだけでOKです。オリジナルの help.pm を参考に
+して、独自の help.pm を作り、以下のパスにおいてください。
 <screen>
 /var/spool/ml/elena/local/lib/FML/Command/User/help.pm
 </screen>
@@ -33,7 +33,7 @@ help コマンドの応答には、このモジュール help.pm が使われます。
 <caution>
 <para>
 他のファイルからカット＆ペーストする時は、
-package の名前空間に気をつけてね
+package の名前空間に気をつけてください。
 </para>
 </caution>
 
diff --git a/fml/doc/ja/tutorial/customize/command_rejectall.sgml b/fml/doc/ja/tutorial/customize/command_rejectall.sgml
index 7975c881..b773e06f 100644
--- a/fml/doc/ja/tutorial/customize/command_rejectall.sgml
+++ b/fml/doc/ja/tutorial/customize/command_rejectall.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: command_rejectall.sgml,v 1.4 2004/04/07 11:07:02 fukachan Exp $
+   $FML: command_rejectall.sgml,v 1.5 2004/10/06 09:07:34 fukachan Exp $
 -->
 
 
@@ -32,4 +32,8 @@ command_mail_restrictions = reject
 何をしても「あなたはメンバーでない」という一点張りの答を返すだけです。
 </para>
 
+<para>
+この設定の問題点は「各行を評価してしまう」つまり無駄ということです。
+</para>
+
 </sect1>
diff --git a/fml/doc/ja/tutorial/customize/post_check_pgp_signature.sgml b/fml/doc/ja/tutorial/customize/post_check_pgp_signature.sgml
index 0264a60c..1e73d1d2 100644
--- a/fml/doc/ja/tutorial/customize/post_check_pgp_signature.sgml
+++ b/fml/doc/ja/tutorial/customize/post_check_pgp_signature.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: post_check_article_thread.sgml,v 1.2 2004/11/14 12:04:58 fukachan Exp $
+   $FML: post_check_pgp_signature.sgml,v 1.1 2005/06/05 09:20:22 fukachan Exp $
 -->
 
 
@@ -12,7 +12,7 @@
 <para>
 この機能を使うには Crypt::OpenPGP モジュールが必要です。
 OS 附属のパッケージシステムなどでインストールして下さい。
-このモジュールが使うモジュールがたくさんあるので、
+このモジュールが依存しているモジュールがたくさんあるので、
 OS 附属のパッケージシステムを使えないとしんどいです。
 </para>
 </caution>
@@ -24,12 +24,11 @@ OS 附属のパッケージシステムを使えないとしんどいです。
 
 <para>
 設定例は次のようになります。
-check_article_thread が、このオプションです
-(なお check_article_thread より良い名称も募集中)。
+check_pgp_signature が、このオプションです。
+電子署名が正当なユーザだけが投稿を許されます。
 <screen>
 article_post_restrictions       =       reject_system_special_accounts
                                         check_pgp_signature
-                                        permit_member_maps
                                         reject
 </screen>
 もちろんデフォルトでは使いません。
@@ -45,12 +44,16 @@ article_post_restrictions       =       reject_system_special_accounts
 	</title>
 
 <para>
-pgp2 pgp5 gpg コマンドで操作してください。
-ただ、
-デフォルトのディレクトリではないこと、
-モードごとに異なるディレクトリを使う
-ことから、
-fmlpgp などの wrapper を利用して下さい。
+PGP のキーリングは、動作条件ごとに別々に用意されます。たとえば記事投稿
+用のキーは $ml_home_dir/etc/pgp-article-post-auth/ ディレクトリ以下に、
+リモート管理用のキーは $ml_home_dir/etc/pgp-admin-command-mail-auth/ 
+ディレクトリ以下に置くといった具合です。
+</para>
+
+<para>
+これらのキーは pgp2 pgp5 gpg コマンドで操作してください。ただ、デフォ
+ルトのディレクトリではないこと、モードごとに異なるディレクトリを使うた
+め、fmlpgp などの wrapper を利用すると便利です。
 <screen>
 例: elena ML で記事投稿で使うキーの生成
 
diff --git a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
index 0d33ce44..a1c3b353 100644
--- a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
+++ b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: post_permit_anyone.sgml,v 1.5 2004/04/07 11:07:02 fukachan Exp $
+   $FML: post_permit_anyone.sgml,v 1.6 2004/10/06 09:07:34 fukachan Exp $
 -->
 
 
@@ -39,6 +39,17 @@ article_post_restrictions =	reject_system_special_accounts
 				permit_member_maps
 				reject
 </screen>
+この意味は
+「root  などシステムの特別なアカウントは弾き」
+「member_maps にあるユーザであれば投稿を許す」
+いづれにもマッチしないなら「投稿を拒否する」
+となります。
+</para>
+
+<para>
+なお「rejectなになに」および「 permitなになに」という命令はマッチした
+ところで処理が終りに、マッチしない場合は次の条件を試すことになっていま
+す。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/customize/recipe.filter.attachments.sgml b/fml/doc/ja/tutorial/customize/recipe.filter.attachments.sgml
index e2a35b2a..6ada7c70 100644
--- a/fml/doc/ja/tutorial/customize/recipe.filter.attachments.sgml
+++ b/fml/doc/ja/tutorial/customize/recipe.filter.attachments.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: recipe.filter.attachments.sgml,v 1.2 2004/12/08 11:27:45 fukachan Exp $
+   $FML: recipe.filter.attachments.sgml,v 1.3 2004/12/09 03:55:18 fukachan Exp $
 -->
 
 
@@ -68,7 +68,7 @@ $distribute_verify_request_start_hook = q{
 <screen>
 Content-Disposition: attachment;
 </screen>
-という表示なることを前提に、これを引っかけるという案もある。
+という表示になることを前提に、これを引っかけるという案もあります。
 <screen>
 $distribute_verify_request_start_hook = q{
     my $msg = $curproc->incoming_message() || undef;
diff --git a/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml b/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml
index 7242c250..18e59b20 100644
--- a/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml
+++ b/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: recipe.filter.spamassassin.sgml,v 1.2 2004/05/20 12:34:26 fukachan Exp $
+   $FML: recipe.filter.spamassassin.sgml,v 1.3 2004/10/06 09:07:35 fukachan Exp $
 -->
 
 
@@ -14,6 +14,15 @@ spamassassin で SPAM メールを無視する (HOOK を使った例)。
 <answer>
 
 <para>
+<caution>
+<para>
+そもそも spamassassin をよびだす内蔵フィルタがあるのですが、
+それをあえて使わない例です。
+</para>
+</caution>
+</para>
+
+<para>
 HOOK でなんとかする/ごまかす例。
 <screen>
 $distribute_verify_request_end_hook = q{