fix description to catch up current implementation.

fix variable names to current ones.
clean up.

7 files changed, 148 insertions, 66 deletions

diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml
index 73039fd1..88ee08da 100644
--- a/fml/doc/ja/tutorial/setup/config.cf.sgml
+++ b/fml/doc/ja/tutorial/setup/config.cf.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: config.cf.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $
+   $FML: config.cf.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $
 -->
 
 <sect1 id="setup.config.cf">
@@ -10,11 +10,9 @@
 <para>
 makefml は、
 makefml newml を実行した際に、
-各ＭＬごとに config.cf (設定ファイル) と
-fml を起動するために MTA が呼び出すファイルである
-(postfix のための) include 類および
-~fml/.qmail-*
-など必要な設定ファイル一式を用意します。
+そのＭＬの config.cf などの設定ファイル群を一式を作り、
+さらに、MTA がfml を起動する際に使う include 類( postfix 用)および~
+fml/.qmail-* ( qmail 用)など必要な設定ファイル一式を用意します。
 <screen>
 % su fml
 % makefml newml elena
@@ -25,30 +23,35 @@ config.cf include include-ctl include-error
 </screen>
 </para>
 
-<para>
-(現状)ＭＬのカスタマイズは config.cf をエディタで編集して下さい。
-</para>
-
 <warning>
+
 <para>
-まだ、設定ツールはできていません。
+現状、設定支援ツールがまだないので、ＭＬのカスタマイズは config.cf を
+エディタで編集して下さい。
 </para>
+
 </warning>
 
+<para>
+makefml newml が作る config.cf には、ほとんど何も定義されていません。
+config.cf の先頭の ml_domain と ml_name もコメントになっていますが、そ
+れらはコマンドの引数から自動的に決定されます。
+</para>
 
 <para>
-config.cf には、ほとんど何も定義されていません。config.cf の先頭の 
-ml_domain と ml_name もコメントになっていますが、それらはコマンドの引
-数で決まります。
 たとえば /var/spool/ml/elena/include ファイルは
 <screen>
 "| /usr/local/libexec/fml/distribute elena@fml.org"
 </screen>
 そして、/var/spool/ml/elena/include-ctl ファイルは
 <screen>
+"| /usr/local/libexec/fml/command elena@fml.org"
 </screen>
-などとなっています。このコマンド引数の elena@fml.org の部分から
-ml_domain と ml_name を設定しています。
+などとなっています。MTAから起動された 
+/usr/local/libexec/fml/distribute
+コマンドなどが、このコマンド引数の elena@fml.org の部分からml_domain 
+と ml_name を自動的に設定します。そのため config.cf ではコメントのまま
+で問題ありません。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
index 50fc3fe6..5d3ea810 100644
--- a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
+++ b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: merge.fml4to8.sgml,v 1.2 2004/03/18 14:51:25 fukachan Exp $
+   $FML: merge.fml4to8.sgml,v 1.3 2004/03/31 06:28:19 fukachan Exp $
 -->
 
 
@@ -31,7 +31,7 @@ fml4 の $DIR ($ml_home_dirにあたるもの)、
 <para>
 上書きしてしまうと、一斉に移行を強制することになるし、失敗した時が痛過
 ぎます。やっぱり、少しずつ移行していきたいよね？また、少しずつ移行する
-場合にも、出来れば、逆戻りができたほうがいい。
+場合にも、出来れば、逆戻りができたほうがいいでしょう。
 </para>
 
 <para>
@@ -94,16 +94,22 @@ fml8 は fml4 を一旦忘れて、一から再設計、再コーディングされたソフトウ
 </para>
 
 <para>
-いくつかの例をあげよう。
+以下、いくつかの例をあげます。
 </para>
 
+
+<sect2>
+	<title>
+	誰でも投稿可能にしたい
+	</title>
+
 <para>
 「登録されたユーザからのみ投稿が可能」なのは fml4 でも fml8 でもデフォ
-ルトです。もし、誰からの投稿も許す場合、fml4 では
+ルトです。もし誰でも投稿可能にしたいなら、fml4 (の config.ph ファイル)では
 <screen>
 $PERMIT_POST_FROM = "anyone";
 </screen>
-としますが、fml8 では
+としますが、fml8 (の config.cf)では
 <screen>
 article_post_restrictions = reject_system_special_accounts
                             permit_anyone
@@ -112,20 +118,36 @@ article_post_restrictions = reject_system_special_accounts
 となります。
 </para>
 
+</sect2>
+
+<sect2>
+	<title>
+	Subject タグ
+	</title>
+
 <para>
-デフォルトでは「Subjectのタグがない」。これも同じです。
-しかしながら変更はこうなります。fml4 での
+デフォルトでは「Subjectのタグがない」。
+これも &fml4; と &fml8; で同じです。
+そして、fml4 での
 <screen>
 $SUBJECT_TAG_TYPE = '[:]';
 </screen>
 は fml8 の
 <screen>
 article_header_rewrite_rules += rewrite_article_subject_tag
-article_subject_tag = [$ml_name:%05d]
+
+article_subject_tag           = [$ml_name:%05d]
 </screen>
-に相当します。
+に相当しています。
 </para>
 
+</sect2>
+
+<sect2>
+	<title>
+	特定のコマンドを使えなくする
+	</title>
+
 <para>
 「members コマンドなどが使えない」これは fml8 ではデフォルトです。
 fml4 の以下のコマンドに対応するものは不要です。
@@ -142,9 +164,12 @@ fml4 の以下のコマンドに対応するものは不要です。
 <para>
 fml4 以前および fml4 非推奨設定の状態では「フィルタは使わない」ように
 なっています。しかし、fml8 では「フィルタを使う」がデフォルトです。
-そのため、場合によっては 
-/etc/fml/site_default_config.cf で一度「デフォルトでは使わない」に設定
-を変更し、その上で、あらためて以下の例外ルールを適用する必要があります。
+</para>
+
+<para>
+そのため、場合によっては /usr/local/etc/fml/site_default_config.cf で
+一度「デフォルトでは使わない」に設定を変更し、その上で、あらためて以下
+の例外ルールを適用する必要があります。
 </para>
 
 <para>
@@ -152,6 +177,8 @@ fml4 と異なり、subscribe, chaddr, unsubscribe はconfirmation が必須と
 なっています。現状、confirmation を抑制することは出来ません。
 </para>
 
+</sect2>
+
 </sect1>
 
 
@@ -235,6 +262,24 @@ fml8 の aliases ファイルに該当するＭＬ部分の設定を追加
 が必要です。
 </para>
 
+<para>
+逆に
+aliases
+の重複さえなければ、
+同じシステム上に
+&fml4;
+と
+&fml8;
+が存在しても問題ありません。
+もちろん同一ＭＬが
+&fml4;
+と
+&fml8;
+の双方に存在しても問題ありませんが、
+実際に動くのは、
+もちろんいづれか(MTA から起動されるようになっている)一方だけです。
+</para>
+
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/setup/newml.recipes.sgml b/fml/doc/ja/tutorial/setup/newml.recipes.sgml
index 46803e28..8dc4c5da 100644
--- a/fml/doc/ja/tutorial/setup/newml.recipes.sgml
+++ b/fml/doc/ja/tutorial/setup/newml.recipes.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: @recipe_template,v 1.1 2003/01/07 11:39:13 fukachan Exp $
+   $FML: newml.recipes.sgml,v 1.1 2003/12/21 03:19:14 fukachan Exp $
 -->
 
 
@@ -30,9 +30,8 @@ ${ml_name}-admin: 管理者のメールアドレス
 $newml_command_ml_admin_default_address 
 変数の値が入ります。
 
-デフォルトでは、どのＭＬでも
-/etc/fml/main.cf で定義されている管理者のアドレス $fml_owner 
-が使われます。
+デフォルトでは、どのＭＬでも /usr/local/etc/fml/main.cf で定義されてい
+る管理者のアドレス $fml_owner が使われます。
 
 それ以外のものにしたい場合、
 $newml_command_ml_admin_default_address 
@@ -72,9 +71,9 @@ newml_command_mta_config_list に MTA のリストが定義されています。
 <screen>
 newml_command_mta_config_list -= qmail
 </screen>
-
+としてください。~/.qmail-* ファイルの生成がされなくなります。
 </para>
-~/.qmail-* の生成が止まります。
+
 </answer>
 
 </qandaentry>
diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml
index f52ed5cc..c7475235 100644
--- a/fml/doc/ja/tutorial/setup/newml.sgml
+++ b/fml/doc/ja/tutorial/setup/newml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: newml.sgml,v 1.5 2003/11/24 04:44:58 fukachan Exp $
+   $FML: newml.sgml,v 1.6 2003/12/21 03:19:14 fukachan Exp $
 -->
 
 
@@ -28,7 +28,19 @@ makefml を使ってＭＬを作成します。
 <screen>
 % su fml
 % makefml newml elena
+   ... 処理の様子が出力される(略) ...
 </screen>
+デフォルトの/var/spool/ml以外にパスを切替えたい場合は
+makefml newdomain コマンドでパスを指定して下さい。
+<screen>
+% su root
+# makefml newdomain fml.org /var/spool/virtual/fml.org
+# exit
+% su fml
+% makefml newml elena
+   ... 処理の様子が出力される(略) ...
+</screen>
+
 </para>
 
 
@@ -52,7 +64,8 @@ makefml を使ってＭＬを作成します。
    <listitem>
         <para>
 	/var/spool/ml/etc/mail/aliases に elena の設定を仕込む。
-	postalias で /var/spool/ml/etc/mail/aliases.db を再生成する。
+	postalias コマンドで
+	/var/spool/ml/etc/mail/aliases.db を再生成する。
         </para>
    </listitem>
 
@@ -70,6 +83,7 @@ makefml を使ってＭＬを作成します。
 
    <listitem>
         <para>
+	HTML 化された記事を置く場所として以下の階層を用意する/作る。
 	<screen>
 	~fml/public_html/fml/mlarchive/$domain/$ml/
 	</screen>
@@ -120,16 +134,19 @@ makefml を使ってＭＬを作成します。
 makefml を使ってＭＬを作成します。
 使い方は &fml4; と同様ですが、ＭＬ名にきちんとドメインまでつけて下さい。
 <screen>
+% su root
+# makefml newdomain nuinui.net /var/spool/virtual/nuinui.net
+# exit
 % su fml
-% makefml newdomain nuinui.net /var/spool/virtual/nuinui.net
 % makefml newml elena@nuinui.net
 </screen>
 </para>
 
 <para>
 newdomainコマンドでは、ドメインと使うml_home_prefixディレクトリのペア
-を指定します。このコマンドは /etc/fml/ml_home_prefix ファイルの編集を
-代行します。上の例では ml_home_prefix ファイルに次の行を追加します。
+を指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファイ
+ルの編集を代行します。上の例では ml_home_prefix ファイルに次の行を追加
+します。
 <screen>
 nuinui.net /var/spool/virtual/nuinui.net
 </screen>
diff --git a/fml/doc/ja/tutorial/setup/postfix.sgml b/fml/doc/ja/tutorial/setup/postfix.sgml
index dee6f602..27947294 100644
--- a/fml/doc/ja/tutorial/setup/postfix.sgml
+++ b/fml/doc/ja/tutorial/setup/postfix.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: postfix.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $
+   $FML: postfix.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $
 -->
 
 <sect1 id="setup.postfix.aliases">
@@ -26,8 +26,9 @@ postfix の設定については
 
 <para>
 makefml はシステムの aliases (例: /etc/mail/aliases)を変更することはあ
-りませんが、$ml_home_prefix/etc/mail/aliases への追加と aliases.db の
-更新は自動的に行なわれています。
+りません。各ドメインごとにある alias ファイル 
+$ml_home_prefix/etc/mail/aliases へ必要な設定を追加することと、そのファ
+イルから aliases.db を再生成する作業を行ないます。
 </para>
 
 
diff --git a/fml/doc/ja/tutorial/setup/procmail.sgml b/fml/doc/ja/tutorial/setup/procmail.sgml
index 07afe5aa..ad5cf285 100644
--- a/fml/doc/ja/tutorial/setup/procmail.sgml
+++ b/fml/doc/ja/tutorial/setup/procmail.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: procmail.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $
+   $FML: procmail.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $
 -->
 
 <sect1 id="setup.procmail">
@@ -16,16 +16,20 @@
 
 <para>
 このような場合には、メールのヘッダの To: や Cc: を見て、適切に fml を
-実行する必要があります。そして、&fmldevel; ではユーザが procmail など
-の振分ツールを使うだろうと期待しています :-)そのため、&fmldevel; に振
-り分けツールは用意されていません。OS のパッケージシステムなどを使って
-振り分けツールをインストールして下さい。
+実行する必要があります。
 </para>
 
 <para>
-makefml は newml の際に、~/.procmailrc の見本を 
-/var/spool/ml/etc/procmail/procmailrc 
-に作るので、適宜利用してみて下さい。
+こういった場合、&fmldevel; ではユーザが procmail などの振分ツールを使
+うだろうと期待しています:-)そのため、&fmldevel; に振り分けツールは用意
+されていません。OS のパッケージシステムなどを使って振り分けツールをイ
+ンストールして下さい。
+</para>
+
+<para>
+なお makefml は newml の際に、~/.procmailrc の見本を 
+/var/spool/ml/etc/procmail/procmailrc に作るので、適宜利用してみて下さ
+い。
 </para>
 
 
diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml
index 92b56a07..8abd2797 100644
--- a/fml/doc/ja/tutorial/setup/test.sgml
+++ b/fml/doc/ja/tutorial/setup/test.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML$
+   $FML: test.sgml,v 1.4 2003/04/15 14:51:44 fukachan Exp $
 -->
 
 <chapter id="test">
@@ -32,12 +32,13 @@ newml の際の重複チェックを効かせるために
 postfix の aliases をきちんと追加して下さい。
 これをしないと root ＭＬとか作れちゃいます:-)
 </para>
-</warning>
 
 <para>
 qmail をメールサーバに使っている人は特にやることはないとおもいます。
 </para>
 
+</warning>
+
 <para>
 以下では、&fmldevel; と MTA が動いているホスト(ahodori.fml.org)をメー
 ルサーバと呼びます。
@@ -57,16 +58,20 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 </para>
 
 <para>
-まず、メールサーバに個人宛のメールアドレス rudo@fml.org を用意しましょう。
-簡単に実行するには、ユーザ rudo くんを作ればよいでしょう。
+まず、メールサーバに個人宛のメールアドレスを用意しましょう。
+ここでは、ユーザるどくん rudo@fml.org とします。
+<footnote>
+<para>
+簡単に用意するには、ユーザ rudo くんを作ればよいでしょう。
+</para>
+</footnote>
 </para>
 
 <para>
-まず、メールサーバ以外のホストからの到達性を確認して下さい。
-つまり、
-メールサーバ以外のホストから
-rudo@fml.org くんにメールを出し、ちゃんと受けとれるかを
-確認してください。
+まず、メールサーバ以外のホストから rudo@fml.org へメールが届くか？(到
+達性)を確認して下さい。つまり、メールサーバ以外のホストから
+rudo@fml.org くんにメールを出し、ちゃんと受信できているかを確認してく
+ださい。もし受けとれないなら、そもそも Postfix の設定が間違っています。
 </para>
 
 <para>
@@ -75,6 +80,12 @@ rudo@fml.org くんにメールを出し、ちゃんと受けとれるかを
 <screen>
 % echo test |Mail rudo@fml.org
 </screen>
+この場合も、
+もし受けとれないなら、そもそも Postfix の設定が間違っています。
+</para>
+
+<para>
+Postfix の基本設定が正しいと確認できたらＭＬのテストに進んで下さい。
 </para>
 
 </sect1>
@@ -96,10 +107,12 @@ rudo@fml.org を登録して下さい。
 </para>
 
 <para>
-前節と同様に、ホスト外から、そしてホストの上から
+前節と同様に、ホスト外から、そしてホストの上から、それぞれ
 elena@fml.org へテストメールを出してみて下さい。 
 この時、テストメールの From: が rudo@fml.org になっていないと
-いけないことに注意して下さい。
+はじかれます。
+メンバー以外からのメールは受け付けないからです。
+注意して下さい。
 </para>
 
 <sect2>
@@ -152,13 +165,13 @@ fml8 には、今のところ、それに相当するものはありません。
 % makefml newml test
 </screen>
 今、テストしたＭＬのホームディレクトリは
-/var/spool/ml/@test
-に残っていますので、それも消してしまってかまいません。
+/var/spool/ml/@test.日付
+に残っています。
+テストで使っただけですので、これも消してしまってかまいません。
 <screen>
-% rm -fr /var/spool/ml/@test
+% su fml
+% rm -fr /var/spool/ml/@test.日付
 </screen>
-残しておくと、将来(今作った２つ目の) test ML を消そうと思った時に
-困りますからね。
 </para>
 
 </sect1>