fix description to catch up current implementation.

fix variable names to current ones.
clean up.

5 files changed, 47 insertions, 24 deletions

diff --git a/fml/doc/ja/tutorial/command/chapter.sgml b/fml/doc/ja/tutorial/command/chapter.sgml
index db27b548..afd8e2e4 100644
--- a/fml/doc/ja/tutorial/command/chapter.sgml
+++ b/fml/doc/ja/tutorial/command/chapter.sgml
@@ -1,8 +1,8 @@
 <!--
-   $FML: chapter.sgml,v 1.6 2002/07/07 01:57:10 fukachan Exp $
+   $FML: chapter.sgml,v 1.7 2002/12/25 11:50:42 fukachan Exp $
 -->
 
-<chapter>
+<chapter id="fml.command.modules">
 	<title>
 	コマンド(コマンドメール、makefml、CGI)
 	</title>
diff --git a/fml/doc/ja/tutorial/command/dataflow.sgml b/fml/doc/ja/tutorial/command/dataflow.sgml
index d0391702..da5ceaa6 100644
--- a/fml/doc/ja/tutorial/command/dataflow.sgml
+++ b/fml/doc/ja/tutorial/command/dataflow.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: dataflow.sgml,v 1.1 2002/12/25 11:50:42 fukachan Exp $
+   $FML: dataflow.sgml,v 1.2 2004/03/12 14:04:09 fukachan Exp $
 -->
 
 
@@ -47,7 +47,7 @@
 
 <para>
 2) メンバーだけに許されるコマンドの場合、
-   command_restrictionsのルールに従って他の条件を確認し、
+   command_mail_restrictionsのルールに従って他の条件を確認し、
    許されたなら、呼び出しルーチンへ処理が移ります。
 </para>
 
@@ -63,7 +63,7 @@ FML::Command 経由でコマンドが実行されます。
 admin コマンドの実行は、ここでは行なわれません。
 「admin ...」コマンドは、まず一般ユーザ権限で実行され、
 FML::Command::User::admin クラスが呼び出されます。
-この中で、$admin_command_restrictions に基づいて、リモート権限があるか？
+この中で、$admin_command_mail_restrictions に基づいて、リモート権限があるか？
 が確認され、もう一度 FML::Command 経由で管理者権限の
 「FML::Command::Admin::コマンド」クラスが呼び出されます。
 </para>
diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml
index 3393349a..5631a374 100644
--- a/fml/doc/ja/tutorial/command/extension.sgml
+++ b/fml/doc/ja/tutorial/command/extension.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: extension.sgml,v 1.9 2003/04/13 04:36:10 fukachan Exp $
+   $FML: extension.sgml,v 1.10 2003/04/15 14:51:36 fukachan Exp $
 -->
 
 
@@ -12,7 +12,7 @@
 
 <sect1 id="fml.command.hack.commandmail">
 	<title>
-	コマンドの拡張: コマンドメール
+	コマンドの拡張: コマンドメールの場合
 	</title>
 
 
@@ -52,7 +52,7 @@ FML::Command 以下から適当に cut and paste して
 というファイルを置き、site_default_config.cf に許可するコマンドリスト
 に追加してください。
 <screen>
-commands_for_user += uja
+user_command_mail_allowed_commands += uja
 </screen>
 </para>
 
@@ -73,7 +73,7 @@ FML::Command 以下から適当に cut and paste して
 というファイルを置き、site_default_config.cf に許可するコマンドリスト
 に追加してください。
 <screen>
-commands_for_privileged_user += uja
+admin_command_mail_allowed_commands += uja
 </screen>
 </para>
 
@@ -84,7 +84,7 @@ commands_for_privileged_user += uja
 
 <sect1 id="fml.command.hack.makefml">
 	<title>
-	コマンドの拡張: makefml
+	コマンドの拡張: makefml の場合
 	</title>
 
 
@@ -117,7 +117,7 @@ FML::Command 以下から適当に cut and paste して
 </screen>
 というファイルを置けば有効になります
 モジュールを置くだけで有効になります。
-commands_for_ 系の変数の設定変更は不要です。
+*_allowed_commands 系の変数の設定変更は不要です。
 </para>
 
 
@@ -127,7 +127,7 @@ commands_for_ 系の変数の設定変更は不要です。
 
 <sect1 id="fml.command.hack.cgi">
 	<title>
-	コマンドの拡張: CGI
+	コマンドの拡張: CGI の場合
 	</title>
 
 
@@ -161,7 +161,7 @@ FML::Command 以下から適当に cut and paste して
 というファイルを置き、site_default_config.cf に許可するコマンドリスト
 に追加してください。
 <screen>
-commands_for_admin_cgi += uja
+admin_cgi_allowed_commands += uja
 </screen>
 </para>
 
diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml
index 24ac4da5..3f2c7cb3 100644
--- a/fml/doc/ja/tutorial/command/internal.sgml
+++ b/fml/doc/ja/tutorial/command/internal.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: internal.sgml,v 1.6 2003/04/15 14:51:36 fukachan Exp $
+   $FML: internal.sgml,v 1.7 2004/03/12 14:04:09 fukachan Exp $
 -->
 
 <sect1 id="fml.command.internal.change">
@@ -14,6 +14,25 @@
 </para>
 
 <para>
+&fml4; では、適当な関数、たとえば myProcHelpFileSendBack を作り、
+%LocalProcedure に書いておきます。
+<screen>
+%LocalProcedure = (
+                    'help',     'myProcHelpFileSendBack',
+                );
+</screen>
+myProcHelpFileSendBack をあえて書き下すと、つぎのようなものでしょう。
+<screen>
+sub myProcHelpFileSendBack
+{
+    local($proc, *Fld, *e, *misc) = @_;
+    my $UJA_FILE = "/some/where/help";
+    &SendFile($Envelope{'Addr2Reply:'}, "UJA $ML_FN", $UJA_FILE);
+}
+</screen>
+</para>
+
+<para>
 &fmldevel; では help ファイルを送り返すコードの実体は
 FML::Command::User::help にあり、
 FML::Process::Command クラスから
@@ -36,7 +55,7 @@ sub process
 {
     my ($self, $curproc, $optargs) = @_;
     my $config    = $curproc->{ config };
-    my $charset   = $config->{ reply_message_charset_ja };
+    my $charset   = $config->{ report_mail_charset_ja };
     my $help_file = $config->{ help_file };
 
     # template substitution: kanji code, $varname expansion et. al.
@@ -62,8 +81,12 @@ sub process
 ここで $curproc はハッシュリファレンスで、&fml4; の %Envelope におおむ
 ね相当します。名前の通り、UNIX カーネルでおなじみの current process 構
 造体へのポインタのようなもので、プロセスに関連するいろいろなデータ構造
-やオブジェクトへのリファレンスを含んでいます。そして $config ハッシュ
-として蓄えられている設定変数空間は、&fml4; ではグローバル変数です。
+やオブジェクトへのリファレンスを含んでいます。
+</para>
+
+<para>
+変数は、&fml4; ではグローバル変数群です。一方 &fml8; では $config オブ
+ジェクトを通じてアクセスできる設定変数空間の中にあります。
 </para>
 
 <para>
@@ -77,10 +100,10 @@ $curproc->reply_message() は引数によって振舞いがことなりますが、
 </para>
 
 <para>
-キューに入れられたメッセージ群は、プロセスの終了直前に一通のメールとし
-て組み立てなおされ、Mail::Delivery クラス経由で送信されます。メッセー
-ジキューの種類がファイルとメッセージが混在していれば、適宜 MIME マルチ
-パートのメッセージが生成されます。
+キューに入れられたメッセージ群は、プロセスの終了直前に受信者ごとにメッ
+セージはまとめられ一通のメールとして組み立てなおされ、Mail::Delivery 
+クラス経由で送信されます。メッセージキューの種類がファイルとメッセージ
+が混在していれば、適宜 MIME マルチパートのメッセージが生成されます。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/command/module.sgml b/fml/doc/ja/tutorial/command/module.sgml
index a51c956a..2cfa77f3 100644
--- a/fml/doc/ja/tutorial/command/module.sgml
+++ b/fml/doc/ja/tutorial/command/module.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: module.sgml,v 1.3 2002/07/07 01:57:11 fukachan Exp $
+   $FML: module.sgml,v 1.4 2003/04/15 14:51:36 fukachan Exp $
 -->
 
 
@@ -18,11 +18,11 @@
 <para>
 FML::Command:: クラスは以下のような構成になっています。
 <screen>
-FML::Command		FML::Command クラス以下への入口
+FML::Command		FML::Command クラス以下への入口、dispatcher
 FML::Command::User	ユーザ用コマンド群
 FML::Command::Admin	管理者用コマンド群
 </screen>
-例えば、(コマンドメールでの)ユーザ用のコマンドの場合
+例えば、(コマンドメールでの)ユーザ用コマンドの場合
 FML::Command を経由して
 FML::Command::User::コマンド
 モジュールを使うことになります。