12 files changed, 121 insertions, 64 deletions

diff --git a/fml/doc/ja/tutorial/usage/chaddr.sgml b/fml/doc/ja/tutorial/usage/chaddr.sgml
index 070d28ce..46984feb 100644
--- a/fml/doc/ja/tutorial/usage/chaddr.sgml
+++ b/fml/doc/ja/tutorial/usage/chaddr.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chaddr.sgml,v 1.4 2005/06/25 15:11:38 fukachan Exp $
+   $FML: chaddr.sgml,v 1.5 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -16,10 +16,17 @@ chaddr 旧アドレス 新アドレス
 </screen>
 と書いたメールを
 elena-ctl@fml.org  に送って下さい。
+</para>
+
+<para>
 旧アドレス、新アドレス
-どちらのアドレスから送っても構いません。
-confirmation が返送されます。
-その confirmation に返答すると実際にアドレスが変更されます。
+どちらのアドレスから送ってもかまいません。
+</para>
+
+<para>
+両方のアドレスに confirmation が返送されます。
+その confirmation に返答してください。
+本人であると確認がとれれば、実際にアドレスが変更されます。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
index f2c4eec3..0ebd2a17 100644
--- a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
+++ b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml
@@ -1,13 +1,20 @@
 <!--
-   $FML: chapter.onhost.sgml,v 1.17 2008/08/19 03:22:18 fukachan Exp $
+   $FML: chapter.onhost.sgml,v 1.18 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
 <chapter id="usage.onhost">
 	<title>
-	ＭＬサーバのホスト上でコマンドを使うと(ＭＬ管理者に)できること
+	ＭＬサーバ上でコマンドを使うと(ＭＬ管理者に)できること
 	</title>
 
+<para>
+「ＭＬサーバ上でコマンドを使う」というのは、
+「ＭＬサーバ」へ SSH (Secure Shell) でログインし、
+makefml (/usr/local/bin/makefml) コマンドもしくは 
+fml (/usr/local/bin/fml) コマンドを使い、
+&fml8; の設定変更をするという操作を意味しています。
+</para>
 
 <para>
 makefml の基本的な使い方は &fml4; の makefml と同様です。
@@ -20,7 +27,7 @@ makefml の基本的な使い方は &fml4; の makefml と同様です。
 <link linkend="changes.cui">
 『<xref linkend="changes.cui">』
 </link>
-を参照して下さい。
+を参照してください。
 </para>
 
 
@@ -30,16 +37,22 @@ makefml の基本的な使い方は &fml4; の makefml と同様です。
 	</title>
 
 <para>
-makefml を使う操作は confirmation が不要です。makefml を実行できる時点
-で特権的なユーザのはずだからです。たとえば、メンバーの登録は、コマンド
-を実行すると、そのまま処理が行なわれます。
+makefml を使う操作は「confirmation が不要」です。たとえば、メンバーの
+登録は、コマンドを実行すると、そのまま処理が行なわれます。これが許され
+るのは makefml を実行できる時点で、つまりそのサーバにログインできる時
+点で、特権的なユーザであることが認証済みだからです。
 </para>
 
 <para>
-ＭＬサーバのホストに入ることができる(例: slogin してシェルが取れる)人
-は、ＭＬにとって最強の権限を持つ人を意味します。ファイルを直接編集する
-ことで、どんなことでもできるわけですから、無敵です。
-だから特権的な操作であるわけです。
+「正しくサーバが構築されている」ことが大前提です
+(これは &fml8; とは直接の関係がないので説明しません)。
+</para>
+
+<para>
+ＭＬサーバのホストに入ることができる(例: ssh してシェルが取れる)人は、
+ＭＬにとって最強の権限を持つ人を意味します。ファイルを直接編集すること
+で、どんなことでもできるわけですから、無敵です。だから特権的な操作であ
+るわけです。
 </para>
 
 <para>
@@ -49,19 +62,20 @@ makefml を使う操作は confirmation が不要です。makefml を実行できる時点
 
 <para>
 そのためファイルの直接編集などはせずに、通常は「makefml (
-/usr/local/bin/makefml )コマンドを使うことで fml の設定を変更して下さ
-い」という運用ポリシーが推奨されています。もちろんファイルを編集しても
-かまいませんが、その場合、内部構造などをよく理解してからにしてください。
+/usr/local/bin/makefml )コマンドを使うことで &fml8; の設定を変更してく
+ださい」という運用ポリシーが推奨されています。もちろんファイルを編集し
+てもかまいませんが、その場合、内部構造などをよく理解してからにしてくだ
+さい。
 </para>
 
 <para>
-なお、fml コマンドは引数の順番の異なる makefml です。
+なお、fml コマンドは引数の順番の異なる makefml 同等品です。
 <screen>
 makefml コマンド ＭＬ名 オプション
 fml     ＭＬ名 コマンド オプション
 </screen>
 コマンドの中身/動作は同じですので、
-シンタックスの好き嫌いで、どちらかを選んで使ってもらえばよいでしょう。
+シンタックスの好き嫌いで、どちらかを選んで使ってください。
 </para>
 
 </sect1>
@@ -131,6 +145,7 @@ fmlalias [-n]
 fmldoc   モジュール名
 fmlconf  [-n] $ml
 </screen>
+(ん〜 fmlconf だけ意味が違うか…)
 </para>
 
 </sect2>
@@ -147,7 +162,11 @@ PGP / GPG コマンドの操作コマンド(例: fmlpgp)が、これにあたります。
 </para>
 
 <para>
-コマンドラインオプションなどを一切考えない特殊なモードを作り込めば
+実は、下請けのコマンドに渡すオプションを指定する必要があるので、
+オプション解析の段階で困ってしまいます。
+&fml8; のオプションは解析し、
+下請けのコマンドに渡すオプションは解析していはいけません。
+「コマンドラインオプションなどを一切考えない特殊なモード」を作り込めば
 makefml に移すことが出来ないわけではないはずですが、こまりました。
 </para>
 
@@ -213,9 +232,10 @@ libexec/ と bin/ にあるプログラム群(.cgi は除く)すべてに共通する
 &sect.usage.fmldoc;
 &sect.usage.fmlhtmlify;
 
+
 <sect1 id="usage.recipes">
 	<title>
-	Recipes
+	レシピ’s
 	</title>
 
 <!-- TABLE_OF_RECIPES -->
@@ -223,4 +243,5 @@ libexec/ と bin/ にあるプログラム群(.cgi は除く)すべてに共通する
 
 </sect1>
 
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml
index 1e84d650..4c212657 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.10 2005/06/25 15:11:38 fukachan Exp $
+	$FML: command.sgml,v 1.11 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -10,28 +10,32 @@
 
 <para>
 fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
-もらうことができます。例えば、メンバーの登録、削除や、過去の記事を取り
-寄せるなどの処理が代表例です。
+もらうことができます。たとえば、メンバーの登録や削除、過去の記事を取り
+寄せるといった処理です。
 </para>
 
 <important>
+
 <para>
-fml の基本的な使い方は CUI (makefml or fml コマンド) を使った操作です。
+fml の基本的な使い方は CUI (makefml もしくは fml コマンド) を使った操
+作です。
 </para>
 
 <para>
-makefml を使えるということは、ＭＬサーバのホストのシェルが取れている、
-つまり SSH なりでそのホストに入る際にＭＬの管理者であると認証されてい
-るわけです。よって、特権的な操作といえます。
+「makefml を使える」状況とは、すでにＭＬサーバのホストのシェルが取れて
+いることを意味します。つまり SSH (Secure Shell) なりでそのホストに入れ
+る権限がある時点で、そのサーバの管理者であると認証済みです。よって、す
+でに「ＭＬの管理者」として特権的な操作が許される状況といえます。
 </para>
 
 <para>
-一方、コマンドメールなどで一般ユーザに提供する機能には、いろいろな制限
-をかけるべきです。実際、ユーザに提供されているコマンド操作は makefml 
-で可能な操作のごく一部です。つまり、コマンドメールとは makefml のコマ
-ンドの一部を使えなくし、適宜 confirmation を付け加えたコマンド体系と考
-えられます。
+一方、コマンドメールなどで「一般ユーザに提供する機能」には、いろいろな
+制限をかけるべきです。実際、ユーザに提供されているコマンド操作は 
+makefml で可能な操作のごく一部です。つまり、コマンドメールとは makefml 
+のコマンドの一部を使えなくし、適宜 confirmation を付け加えたコマンド体
+系と考えられます。
 </para>
+
 </important>
 
 
@@ -41,8 +45,12 @@ makefml を使えるということは、ＭＬサーバのホストのシェルが取れている、
 	</title>
 
 <para>
+elena@fml.org ＭＬを例にとりましょう。
+</para>
+
+<para>
 elena@fml.org ＭＬの場合、
-コマンドメールを elena-ctl@fml.org に送信してください。
+コマンドメールを elena-ctl@fml.org に送信してもらうことになります。
 メールは MTA が受け、最終的に MTA は
 /usr/local/libexec/fml/command
 というプログラムを実行します。
@@ -56,6 +64,11 @@ command はメールを標準入力から受けとり、
 一通のメール ( MIME/Multipart )にまとめて返送
 しています。
 </para>
+
+<para>
+複数のコマンドの結果すべてを一通のメールに合体しています。
+処理の結果も、送り返すべき記事なども一通です。
+</para>
 </warning>
 
 </sect2>
@@ -79,4 +92,5 @@ CGI でのコマンド処理
 
 </sect2>
 
+
 </sect1>
diff --git a/fml/doc/ja/tutorial/usage/fml.sgml b/fml/doc/ja/tutorial/usage/fml.sgml
index 1c31cbf9..20c9889a 100644
--- a/fml/doc/ja/tutorial/usage/fml.sgml
+++ b/fml/doc/ja/tutorial/usage/fml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fml.sgml,v 1.1 2003/01/05 08:03:23 fukachan Exp $
+   $FML: fml.sgml,v 1.2 2004/10/06 09:07:43 fukachan Exp $
 -->
 
 
@@ -10,8 +10,8 @@
 
 <para>
 引数の順が異なることを除けば、
-fml (/usr/local/bin/fml)
-は makefml と全く同じです。 
+fml (/usr/local/bin/fml) コマンドは
+makefml コマンドと全く同じです。 
 単に、引数順の好き嫌いで使い分けて下さい。
 </para>
 
diff --git a/fml/doc/ja/tutorial/usage/fmlconf.sgml b/fml/doc/ja/tutorial/usage/fmlconf.sgml
index 17187b19..c6c70c13 100644
--- a/fml/doc/ja/tutorial/usage/fmlconf.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlconf.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fmlconf.sgml,v 1.4 2002/07/28 06:26:58 fukachan Exp $
+   $FML: fmlconf.sgml,v 1.5 2004/10/06 09:07:44 fukachan Exp $
 -->
 
 
@@ -11,7 +11,7 @@
 <para>
 fmlconf (/usr/local/bin/fmlconf)
 は引数にＭＬ名をとり、そのＭＬの変数一覧を表示します。
--n をつけるとデフォルトと異なる変数のみを表示します。
+-n をつけるとデフォルト値と異なる変数とその値一覧を表示します。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/guide.sgml b/fml/doc/ja/tutorial/usage/guide.sgml
index 0c46afa1..c97dcd47 100644
--- a/fml/doc/ja/tutorial/usage/guide.sgml
+++ b/fml/doc/ja/tutorial/usage/guide.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: guide.sgml,v 1.3 2005/06/25 15:11:39 fukachan Exp $
+   $FML: guide.sgml,v 1.4 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -21,4 +21,8 @@ guide という名前のファイルがＭＬのホームディレクトリにあれば、そのファ
 イルが送り返されます。
 </para>
 
+<para>
+注: テンプレートのままでは、たいした情報は送られません。
+</para>
+
 </sect1>
diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml
index 9a96f2f6..dda059ad 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.11 2005/06/25 15:11:39 fukachan Exp $
+   $FML: makefml.sgml,v 1.12 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -16,8 +16,8 @@
 ＭＬ名は＠抜きの場合、デフォルトのドメインとなり、アドレスを完全に指定
 すればバーチャルドメインまで含めて makefml がよろしくがんばることになっ
 ています。もちろんデフォルトかバーチャルか否かにかかわらず、常に＠ドメ
-インつきで指定してかまいませんし、その方が良いでしょう。
-例えばデフォルトドメイン(fml.org)であれば、次の二つは同じ意味です。
+インつきで指定してかまいません。むしろ、その方が良いでしょう。
+たとえばデフォルトドメイン(fml.org)であれば、次の二つは同じ意味です。
 <screen>
 % makefml newml elena
 % makefml newml elena@fml.org
@@ -29,7 +29,7 @@
 <link linkend="setup.newml">
 <xref linkend="setup.newml">
 </link>
-を参照して下さい。
+を参照してください。
 </para>
 
 </sect1>
@@ -48,7 +48,7 @@
 ＭＬ名は @ 抜きの場合デフォルトのドメイン、
 アドレスを完全に指定すればバーチャルドメインまで含めて
 makefml が自動的に処理できます。
-例えばデフォルトドメイン(fml.org)であれば、次の二つは同じ意味です。
+たとえばデフォルトドメイン(fml.org)であれば、次の二つは同じ意味です。
 <screen>
 % makefml rmml elena
 % makefml rmml elena@fml.org
@@ -59,7 +59,7 @@ makefml が自動的に処理できます。
 できるだけ newml の反対の動作をします。
 ホームディレクトリを消すとか
 MTA の alias の該当エントリを消すといったことなども
-可能な操作は全て頑張ります。
+可能なかぎり全て行ないます。
 </para>
 
 </sect1>
@@ -111,7 +111,8 @@ resign
 signoff
 unsubscribe
 </screen>
-どれを使っても同じです。
+どれを使っても同じです
+(注: BSD 派と System V 派どちらの流儀でも良いように :-)。
 </para>
 
 
@@ -259,7 +260,7 @@ xxx_maps は
 <para>
 makefml を使える管理者が一番偉い人です。当然:-)、
 makefml を使える管理者は、
-(より権限の弱い)リモート管理のための諸設定を行なうことができます。
+「(より権限の弱い)リモート管理」のための諸設定を行なうことができます。
 </para>
 </warning>
 
@@ -273,7 +274,7 @@ makefml を使える管理者は、
 ＭＬ名は @ 抜きの場合デフォルトのドメイン、
 アドレスを完全に指定すればバーチャルドメインまで含めて
 makefml がよろしくがんばります。
-例えば
+たとえば
 <screen>
 % su fml
 % makefml addadmin elena rudo@nuinui.net
@@ -319,7 +320,7 @@ byepriv
 ＭＬ名は @ 抜きの場合デフォルトのドメイン、
 アドレスを完全に指定すればバーチャルドメインまで含めて
 makefml がよろしくがんばります。
-例えば
+たとえば
 <screen>
 % su fml
 % makefml addmoderator elena rudo@nuinui.net
diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml
index 6f2ff06a..9597a0c1 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.10 2005/06/25 15:11:39 fukachan Exp $
+   $FML: post.sgml,v 1.11 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -11,6 +11,9 @@
 <para>
 elena@fml.org ＭＬ(fml.org の elena ＭＬ)への投稿は、
 普通にメールを elena@fml.org に送信することです。
+</para>
+
+<para>
 メールは MTA が受け、最終的に MTA は
 /usr/local/libexec/fml/distribute
 というコマンドを実行します。
@@ -95,9 +98,10 @@ symlink(2) で結ばれ、同一のファイルです。
 </para>
 
 <para>
-@INC を設定した後、loader (/usr/local/libexec/fml/distribute の実体) 
-は FML::Process::Switch をロードし、$0 を調べます。その名前から自分の
-仕事は配送処理だと知ります。
+@INC (Perl のライブラリサーチパス)を設定した後、
+loader (/usr/local/libexec/fml/distribute の実体) 
+は FML::Process::Switch をロードし、$0 (プロセス名)を調べます。
+その名前から自分の仕事は「配送処理」だと知ります。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/recipes.onhost.sgml b/fml/doc/ja/tutorial/usage/recipes.onhost.sgml
index 036c3eef..07958da1 100644
--- a/fml/doc/ja/tutorial/usage/recipes.onhost.sgml
+++ b/fml/doc/ja/tutorial/usage/recipes.onhost.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML: recipes.onhost.sgml,v 1.2 2008/08/19 07:11:03 fukachan Exp $
+ $FML: recipes.onhost.sgml,v 1.3 2008/08/23 00:38:21 fukachan Exp $
 -->
 
 <qandaset>
@@ -75,7 +75,7 @@ CGI でも同様です。rmml で消していれば reviveml で復活できます。
 
 <para>
 もちろん「rm -fr /var/spool/ml/elena」などとしてＭＬを消去してしまって
-いれば元に戻す方法ありません.バックアップから戻して下さい(こまめにバッ
+いれば元に戻す方法ありません。バックアップから戻して下さい(こまめにバッ
 クアップをとりましょう)。
 </para>
 
diff --git a/fml/doc/ja/tutorial/usage/recipes.user.sgml b/fml/doc/ja/tutorial/usage/recipes.user.sgml
index 6eb1d6e5..1dbd36d7 100644
--- a/fml/doc/ja/tutorial/usage/recipes.user.sgml
+++ b/fml/doc/ja/tutorial/usage/recipes.user.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML: recipes.user.sgml,v 1.1 2005/10/29 04:58:01 fukachan Exp $
+ $FML: recipes.user.sgml,v 1.2 2008/08/19 07:11:03 fukachan Exp $
 -->
 
 <qandaset>
@@ -63,7 +63,7 @@ chaddr リクエストを受け付けると confirmation を
 
 <question>
 <para>
-ML に投稿できるメールアドレスを増やしたい
+ＭＬに投稿できるメールアドレスを増やしたい
 </para>
 </question>
 
diff --git a/fml/doc/ja/tutorial/usage/subscribe.sgml b/fml/doc/ja/tutorial/usage/subscribe.sgml
index e2da40e3..32cff566 100644
--- a/fml/doc/ja/tutorial/usage/subscribe.sgml
+++ b/fml/doc/ja/tutorial/usage/subscribe.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: subscribe.sgml,v 1.4 2006/05/17 13:13:01 fukachan Exp $
+   $FML: subscribe.sgml,v 1.5 2008/08/19 07:11:03 fukachan Exp $
 -->
 
 
@@ -9,7 +9,7 @@
 	</title>
 
 <para>
-elena@fml.org ＭＬの場合、
+elena@fml.org ＭＬに参加したい場合、
 本文に 
 <screen>
 
@@ -22,7 +22,10 @@ subscribe Teresa Testarossa
 </screen>
 と書いたメールを
 elena-ctl@fml.org  に送って下さい。
-メールで confirmation が返送されます。
+</para>
+
+<para>
+メールに対し confirmation が返送されます。
 その confirmation メールに返答すると登録されます。
 </para>
 
diff --git a/fml/doc/ja/tutorial/usage/unsubscribe.sgml b/fml/doc/ja/tutorial/usage/unsubscribe.sgml
index d7444070..2791cfdd 100644
--- a/fml/doc/ja/tutorial/usage/unsubscribe.sgml
+++ b/fml/doc/ja/tutorial/usage/unsubscribe.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: unsubscribe.sgml,v 1.3 2005/06/25 15:11:39 fukachan Exp $
+   $FML: unsubscribe.sgml,v 1.4 2008/08/19 07:11:03 fukachan Exp $
 -->
 
 
@@ -9,14 +9,17 @@
 	</title>
 
 <para>
-elena@fml.org ＭＬの場合、
+elena@fml.org ＭＬを辞めたい場合、
 本文に 
 <screen>
 unsubscribe 名前
 </screen>
 と書いたメールを
 elena-ctl@fml.org  に送って下さい。
-confirmation が返送されます。
+</para>
+
+<para>
+そのメールに対し confirmation が返送されます。
 その confirmation に返答すると削除されます。
 </para>