improve usage around makefml

8 files changed, 265 insertions, 108 deletions

diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml
index 21d25da8..8d2ab602 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.3 2002/07/05 04:01:37 fukachan Exp $
+	$FML: command.sgml,v 1.4 2002/07/07 01:57:12 fukachan Exp $
 -->
 
 <sect1 id="fml.command.bymail">
@@ -13,6 +13,16 @@ fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
 寄せるなどの処理です。
 </para>
 
+<important>
+<para>
+fml の基本的な使い方は makefml での操作です。
+ユーザが使えるコマンド/ユーザに提供されているコマンド操作は 
+その操作のごく一部です。
+それは makefml のコマンドの一部を使えなくし、
+適宜 confirmation を付け加えたものといえます。
+</para>
+</important>
+
 
 <sect2 id="fml.command.bymail.flow">
 	<title>
diff --git a/fml/doc/ja/tutorial/usage/customize.sgml b/fml/doc/ja/tutorial/usage/customize.sgml
deleted file mode 100644
index 81cfc738..00000000
--- a/fml/doc/ja/tutorial/usage/customize.sgml
+++ /dev/null
@@ -1,13 +0,0 @@
-<!--
-   $FML: customize.sgml,v 1.1 2002/07/05 04:01:37 fukachan Exp $
--->
-<chapter id="cuctomize">
-	<title>
-	カスタマイズの事例
-	</title>
-
-
-<!-- procmail -->
-&sect.usage.procmail;
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/usage/fmlconf.sgml b/fml/doc/ja/tutorial/usage/fmlconf.sgml
index ac9739ed..c8f7e318 100644
--- a/fml/doc/ja/tutorial/usage/fmlconf.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlconf.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: fmlconf.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $
+   $FML: fmlconf.sgml,v 1.3 2002/07/07 01:57:12 fukachan Exp $
 -->
 
 <sect1 id="usage.fmlconf">
 	<title>
-	設定を表示する (fmlconf)
+	設定を表示する (fmlconf コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/fmldoc.sgml b/fml/doc/ja/tutorial/usage/fmldoc.sgml
index ef488294..a072b11f 100644
--- a/fml/doc/ja/tutorial/usage/fmldoc.sgml
+++ b/fml/doc/ja/tutorial/usage/fmldoc.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: fmldoc.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
+   $FML: fmldoc.sgml,v 1.2 2002/07/07 01:57:12 fukachan Exp $
 -->
 
 <sect1 id="usage.fmldoc">
 	<title>
-	モジュールのドキュメントを表示する (fmldoc)
+	モジュールのドキュメントを表示する (fmldoc コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
index 1962fb50..1d0cb6c1 100644
--- a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: fmlhtmlify.sgml,v 1.2 2002/07/07 01:57:12 fukachan Exp $
+   $FML: fmlhtmlify.sgml,v 1.3 2002/07/23 09:33:10 fukachan Exp $
 -->
 
 <sect1 id="usage.fmlhtmlify">
 	<title>
-	記事を HTML 化する (fmlhtmlify)
+	記事を HTML 化する (fmlhtmlify コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/fmlthread.sgml b/fml/doc/ja/tutorial/usage/fmlthread.sgml
index ed5ab6fc..cd975917 100644
--- a/fml/doc/ja/tutorial/usage/fmlthread.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlthread.sgml
@@ -1,10 +1,10 @@
 <!--
-	$FML: fmlthread.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
+	$FML: fmlthread.sgml,v 1.2 2002/07/07 01:57:12 fukachan Exp $
 -->
 
 <sect1 id="usage.fmlthread">
 	<title>
-	スレッドを表示する (fmlthread)
+	スレッドを表示する (fmlthread コマンド)
 	</title>
 
 <para>
diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml
index f90ceea4..e7072e0d 100644
--- a/fml/doc/ja/tutorial/usage/makefml.sgml
+++ b/fml/doc/ja/tutorial/usage/makefml.sgml
@@ -1,98 +1,246 @@
 <!--
-   $FML: makefml.sgml,v 1.3 2002/07/02 10:39:39 fukachan Exp $
+   $FML: makefml.sgml,v 1.4 2002/07/07 01:57:12 fukachan Exp $
 -->
 
-<sect1 id="usage.makefml">
+
+<sect1 id="usage.makefml.newml">
 	<title>
-	makefml を使って、ユーザの登録/削除他(あらゆる:)
+	ＭＬの作成
 	</title>
 
 <para>
-makefml の基本的な使い方は &fml4; の makefml と同様です。
-というより、できるだけ互換性を保つように構築する予定です。
+<screen>
+% su fml
+% makefml newml ＭＬ名
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% makefml newml elena
+% makefml newml elena@fml.org
+</screen>
 </para>
 
 <para>
-現状 makefml に命令を与えると admin コマンドと同じ動作をするようになっ
-ています。
-つまり特権的な動作ということです。
-例えば、メンバーの登録に confirmation は必要ありません。
+くわしくは
+<link linkend="setup.newml">
+<xref linkend="setup.newml">
+</link>
+を参照して下さい。
 </para>
 
-<para>
-現在使えるコマンドは以下のものです。
-<itemizedlist>
-	<listitem>
-	<para>
-	メンバーの登録
-	(
-		subscribe
-		add
-	)
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
-	メンバーの削除
-	(
-		bye
-		remove
-		resign
-		signoff
-		unsubscribe
-	)
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
-	アドレスの変更
-	(
-		chaddr
-	)	
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
-	リモート管理者の登録
-	(
-		addadmin
-		addpriv	
-	)	
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
-	リモート管理者の削除
-	(
-		byeadmin
-		byepriv	
-	)	
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
-	ＭＬの作成
-	(
-		newml
-	)
-	</para>
-	</listitem>
-
-	<listitem>
-	<para>
+</sect1>
+
+
+<sect1 id="usage.makefml.rmml">
+	<title>
 	ＭＬの削除
-	(
-		rmml
-	)
-	</para>
-	</listitem>
+	</title>
+
+<para>
+<screen>
+% su fml
+% makefml rmml ＭＬ名
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% makefml rmml elena
+% makefml rmml elena@fml.org
+</screen>
+</para>
+
+<para>
+できるだけ newml の反対の動作をします。
+ホームディレクトリを消すとか
+MTA の alias の該当エントリを消すといったことなども
+できそうなことは全て頑張ります。
+</para>
+
+</sect1>
+
+
+<sect1 id="usage.makefml.user.adddel">
+	<title>
+	ＭＬメンバーの登録と削除
+	</title>
+
+<para>
+一般のＭＬメンバーの登録は useradd 削除は userdel です。
+<screen>
+% su fml
+% makefml useradd ＭＬ名 メールアドレス
+% makefml userdel ＭＬ名 メールアドレス
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% su fml
+% makefml useradd elena rudo@nuinui.net
+% makefml userdel elena rudo@nuinui.net
+% makefml useradd elena@fml.org rudo@nuinui.net
+% makefml userdel elena@fml.org rudo@nuinui.net
+</screen>
+</para>
+
+<para>
+なお、便利なように 
+useradd コマンドは  
+<screen>	
+useradd
+adduser	
+subscribe
+add
+</screen>	
+どれを使っても同じです。
+また、userdel は
+<screen>
+userdel
+deluser
+bye
+remove
+resign
+signoff
+unsubscribe
+</screen>
+でも同様です。
+</para>
+
+
+</sect1>
 
-</itemizedlist>
+
+<sect1 id="usage.makefml.user.chaddr">
+	<title>
+	ＭＬメンバーのアドレス変更
+	</title>
+
+
+<para>
+<screen>
+% su fml
+% makefml useradd ＭＬ名 古いメールアドレス 新しいメールアドレス
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% su fml
+% makefml chaddr elena rudo@nuinui.net teddy@nuinui.net
+% makefml chaddr elena@fml.org rudo@nuinui.net teddy@nuinui.net
+</screen>
+</para>
+
+
+</sect1>
+
+
+
+<sect1 id="usage.makefml.admin.adddel">
+	<title>
+	リモート管理者の登録と削除
+	</title>
+
+<para>
+一般のＭＬメンバーの登録は addadmin 削除は deladmin です。
+<screen>
+% su fml
+% makefml addadmin ＭＬ名 メールアドレス
+% makefml deladmin ＭＬ名 メールアドレス
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% su fml
+% makefml addadmin elena rudo@nuinui.net
+% makefml deladmin elena rudo@nuinui.net
+% makefml addadmin elena@fml.org rudo@nuinui.net
+% makefml deladmin elena@fml.org rudo@nuinui.net
+</screen>
+</para>
+
+<para>
+なお、便利なように 
+addadmin コマンドは  
+<screen>	
+addadmin	
+addpriv
+</screen>	
+どれを使っても同じです。
+また、deladmin は
+<screen>
+byeadmin
+byepriv
+</screen>
+でも同様です。
+</para>
+
+
+</sect1>
+
+
+
+<sect1 id="usage.makefml.moderator.adddel">
+	<title>
+	モデレータの登録と削除
+	</title>
+
+<para>
+一般のＭＬメンバーの登録は addmoderator 削除は delmoderator です。
+<screen>
+% su fml
+% makefml addmoderator ＭＬ名 メールアドレス
+% makefml delmoderator ＭＬ名 メールアドレス
+</screen>
+ＭＬ名は @ 抜きの場合デフォルトのドメイン、
+アドレスを完全に指定すればバーチャルドメインまで含めて
+makefml がよろしくがんばります。
+例えば
+<screen>
+% su fml
+% makefml addmoderator elena rudo@nuinui.net
+% makefml delmoderator elena rudo@nuinui.net
+% makefml addmoderator elena@fml.org rudo@nuinui.net
+% makefml delmoderator elena@fml.org rudo@nuinui.net
+</screen>
+</para>
+
+</sect1>
+
+
+<sect1 id="usage.makefml.log">
+	<title>
+	ログを見る
+	</title>
+
+<para>
+<screen>
+% makefml log elena
+% makefml log elena@fml.org
+</screen>
+</para>
+
+</sect1>
+
+
+<sect1 id="usage.makefml.list">
+	<title>
+	メンバーリスト見る
+	</title>
+
+<para>
+<screen>
+% makefml list elena
+</screen>
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/usage/onhost.sgml b/fml/doc/ja/tutorial/usage/onhost.sgml
index 89d30e09..78854623 100644
--- a/fml/doc/ja/tutorial/usage/onhost.sgml
+++ b/fml/doc/ja/tutorial/usage/onhost.sgml
@@ -1,24 +1,34 @@
 <!--
-	$FML: onhost.sgml,v 1.1 2001/11/24 03:22:59 fukachan Exp $
+   $FML: onhost.sgml,v 1.2 2002/07/05 04:01:37 fukachan Exp $
 -->
 
 <chapter id="usage.onhost">
 	<title>
-	ＭＬ管理者にできること (ＭＬサーバのホスト上で makefml を使う)
+	ＭＬサーバのホスト上でコマンドを使ってできること
+	(ＭＬの一番偉い管理者にできること)
 	</title>
 
 
+<para>
+makefml の基本的な使い方は &fml4; の makefml と同様です。
+というより、できるだけ互換性を保つように構築する予定です。
+</para>
+
 <sect1>
 	<title>
-	ホスト上でできること
+	ホスト上でできること、その権限について
 	</title>
 
 <para>
-ＭＬサーバのホストに入ることができる(例: slogin してシェルが取れる)
-人は、通常ＭＬにとって最強の人を意味します。
+現状 makefml に命令を与えると admin コマンドと同じ動作をするようになっ
+ています。
+つまり特権的な動作ということです。
+例えば、メンバーの登録に confirmation は必要ありません。
 </para>
 
 <para>
+ＭＬサーバのホストに入ることができる(例: slogin してシェルが取れる)
+人は、通常ＭＬにとって最強の人を意味します。
 ファイルを直接編集することで、どんなことでもできるわけですから、
 無敵です。
 </para>
@@ -31,6 +41,8 @@
 <para>
 そのため、通常は makefml ( /usr/local/bin/makefml )を
 使うことで、fml を操作して下さい。
+というのが fml の操作ポリシーです。
+もちろんファイルを編集しても構いませんが。
 </para>
 
 </sect1>