fix description to catch up current implementation.

fix variable names to current ones.
clean up.

6 files changed, 66 insertions, 42 deletions

diff --git a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
index 2d93603a..36e6facd 100644
--- a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
+++ b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
@@ -1,11 +1,10 @@
 <!--
-   $FML: chapter.onhost.sgml,v 1.8 2003/04/15 14:51:46 fukachan Exp $
+   $FML: chapter.onhost.sgml,v 1.9 2004/02/26 05:29:59 fukachan Exp $
 -->
 
 <chapter id="usage.onhost">
 	<title>
-	ＭＬサーバのホスト上でコマンドを使ってできること
-	(ＭＬの一番偉い管理者にできること)
+	ＭＬサーバのホスト上でコマンドを使うと(ＭＬ管理者に)できること
 	</title>
 
 
@@ -15,6 +14,14 @@ makefml の基本的な使い方は &fml4; の makefml と同様です。
 つまり互換性を保つようにしてあります。
 </para>
 
+<para>
+相違点についての詳細は
+<link linkend="changes.cui">
+『<xref linkend="changes.cui">』
+</link>
+を参照して下さい。
+</para>
+
 
 <sect1 id="usage.onhost.priviledge">
 	<title>
@@ -22,8 +29,9 @@ makefml の基本的な使い方は &fml4; の makefml と同様です。
 	</title>
 
 <para>
-makefml を使う操作は
-例えば、メンバーの登録に confirmation は必要ありません。
+makefml を使う操作は confirmation が不要です。makefml を実行できる時点
+で特権的なユーザのはずだからです。たとえば、メンバーの登録は、コマンド
+を実行すると、そのまま処理が行なわれます。
 </para>
 
 <para>
@@ -34,8 +42,8 @@ makefml を使う操作は
 </para>
 
 <para>
-しかしながら、人間間違いを犯すもので、ついフォーマットを
-間違えるといったことがあります。
+しかしながら、人間まちがいを犯すもので、ついファイルのフォーマットを間
+違えたりします。
 </para>
 
 <para>
@@ -68,7 +76,7 @@ fml     ＭＬ名 コマンド オプション
 どうも、このポリシーでは、やたらと多くなるだけのようです。「できるだけ
 分離せずに makefml に統合するべき」でしょう。そこで、以下のような基準
 に基づき用意することにします(2003/03 記)。makefml に統合してある方が 
-admin コマンドや CGI でも使えるようになりうるので、再利用性が高いので
+admin コマンドや CGI でも使えるようになりうるので、再利用性が高く、
 有益です。
 </para>
 
@@ -113,9 +121,9 @@ fml     ＭＬ名 コマンド オプション
 	</title>
 
 <para>
-特定のＭＬと関わりのないものもある。モジュールのドキュメントを見るとか、
-OS のアカウントやエイリアス一覧を表示させる類のものだ。
-これは fml が頭文字につくコマンドを別途用意する。
+特定のＭＬと関わりのないコマンドがあり得ます。たとえば、モジュールのド
+キュメントを見るとか、OS のアカウントやエイリアス一覧を表示させる類の
+ものです。これは fml が頭文字につくコマンドを別途用意します。
 <screen>
 fmladdr	 [-n]
 fmlalias [-n]
@@ -134,13 +142,13 @@ fmlconf  [-n] $ml
 	</title>
 
 <para>
-これが一番困るケースのような気がする。どうしても作る必要があるなら、
-fml が頭文字につくコマンドを別途用意する。
+これが一番困るケースのような気がしますが、どうしても作る必要があるなら、
+fml が頭文字につくコマンドを別途用意します。
 </para>
 
 <para>
 例: 記事のスプールを HTML 化する。
-でも、fml に限らず、MH フォルダでも構わない。
+でも、fml に限らず、ソースが MH フォルダなどでも構わない。
 <screen>
 fmlhtmlify [-I DIR] $src_dir $dst_dir
 </screen>
diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml
index c62dfaf5..48e7d70e 100644
--- a/fml/doc/ja/tutorial/usage/command.sgml
+++ b/fml/doc/ja/tutorial/usage/command.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: command.sgml,v 1.6 2002/09/28 14:14:07 fukachan Exp $
+	$FML: command.sgml,v 1.7 2003/04/15 14:51:46 fukachan Exp $
 -->
 
 <sect1 id="fml.command.bymail">
@@ -25,10 +25,10 @@ makefml を使えるということは、ＭＬサーバのホストのシェルが取れている、
 </para>
 
 <para>
-一方、コマンドメールなどでユーザに提供されているコマンド操作は makefml 
-で可能な操作のごく一部です。つまり、コマンドメールとは makefml のコマ
-ンドの一部を使えなくし、適宜 confirmation を付け加えたコマンド体系といっ
-てよいでしょう。
+一方、コマンドメールなどで一般ユーザに提供する機能は制限するべきです。
+実際、ユーザに提供されているコマンド操作は makefml で可能な操作のごく
+一部です。つまり、コマンドメールとは makefml のコマンドの一部を使えな
+くし、適宜 confirmation を付け加えたコマンド体系といってよいでしょう。
 </para>
 </important>
 
@@ -80,3 +80,5 @@ CGI でのコマンド処理
 </sect2>
 
 </sect1>
+
+
diff --git a/fml/doc/ja/tutorial/usage/fmladdr.sgml b/fml/doc/ja/tutorial/usage/fmladdr.sgml
index cdf4b36e..33475ea3 100644
--- a/fml/doc/ja/tutorial/usage/fmladdr.sgml
+++ b/fml/doc/ja/tutorial/usage/fmladdr.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: fmladdr.sgml,v 1.4 2002/07/28 06:26:58 fukachan Exp $
+   $FML: fmladdr.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $
 -->
 
 <sect1 id="usage.fmladdr">
 	<title>
-	設定を表示する (fmladdr コマンド)
+	アドレス一覧を表示する (fmladdr コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/fmlalias.sgml b/fml/doc/ja/tutorial/usage/fmlalias.sgml
index eb41f887..e8bb32b3 100644
--- a/fml/doc/ja/tutorial/usage/fmlalias.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlalias.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: fmlalias.sgml,v 1.4 2002/07/28 06:26:58 fukachan Exp $
+   $FML: fmlalias.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $
 -->
 
 <sect1 id="usage.fmlalias">
 	<title>
-	設定を表示する (fmlalias コマンド)
+	エイリアスの一覧を表示する (fmlalias コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml
index 9608fee2..ded99f97 100644
--- a/fml/doc/ja/tutorial/usage/makefml.sgml
+++ b/fml/doc/ja/tutorial/usage/makefml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: makefml.sgml,v 1.6 2002/07/28 23:33:43 fukachan Exp $
+   $FML: makefml.sgml,v 1.7 2003/04/15 14:51:46 fukachan Exp $
 -->
 
 
@@ -200,12 +200,21 @@ off の反対
 % makefml list elena recipient
 </screen>
 は受信者のリストを表示します。
-この形式でいいのか疑問なんですが…
 </para>
 
-<!--
- XXX-TODO この形式でいいのか疑問なんですが… (makefml list elena recipient)
--->
+<para>
+実際には、config.cf で利用可能な任意のマップの表示が可能です。
+<screen>
+% makefml list elena MAP名
+</screen>
+なお、長い変数名を打ち込むのも大変なので、
+primary_xxx_map や
+xxx_maps は
+<screen>
+% makefml list elena xxx
+</screen>
+と省略しても良いことになっています。  
+</para>
 
 </sect1>
 
@@ -230,8 +239,8 @@ config.cf などをエディタで編集して下さい。
 
 <warning>
 <para>
-fml 管理者は(当然:-)、
-リモート管理のための諸設定をすることができます。
+makefml を使える管理者が一番偉い人です。当然:-)、
+(より権限の弱い)リモート管理のための諸設定をすることができます。
 </para>
 </warning>
 
diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml
index 0f4d8c64..13250e5a 100644
--- a/fml/doc/ja/tutorial/usage/post.sgml
+++ b/fml/doc/ja/tutorial/usage/post.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: post.sgml,v 1.6 2002/09/28 14:14:07 fukachan Exp $
+   $FML: post.sgml,v 1.7 2003/04/15 14:51:46 fukachan Exp $
 -->
 
 <sect1 id="usage.post">
@@ -81,20 +81,25 @@ fml ブートローダ
 
 
 <para>
-libexec/loader は etc/fml/main.cf を読みこみます。
-fml_version 変数から使うべきライブラリのバージョンを決めます。
-例えば fml_vesrion が current-20010501 となっていたら
-/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといった
-具合です。
+/usr/local/libexec/loader は /usr/local/etc/fml/main.cf を読みこみます。
+fml_version 変数から使うべきライブラリのバージョンを決めます。例えば 
+fml_vesrion が current-20010501 となっていたら
+/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといっ
+た具合です。
 </para>
 
 <para>
-@INC を設定した後、
-loader は FML::Process::Switch をロードし、
-$0 を調べます。
-その名前から自分の仕事は配送処理だと知ります。
-配送処理なので
-FML::Process::Distribute をロードし、配送処理に移ります。
+@INC を設定した後、loader (/usr/local/libexec/fml/distribute の実体) 
+は FML::Process::Switch をロードし、$0 を調べます。その名前から自分の
+仕事は配送処理だと知ります。
+</para>
+
+<para>
+loader は /usr/local/etc/fml/defaults/バージョン/modules ファイルを調べ、
+ロードするべきモジュールが
+FML::Process::Distribute 
+だと知ります。
+最後に、このクラスをロードし、配送処理に移ります。
 </para>
 
 </sect2>