clean up / fixed.

9 files changed, 131 insertions, 71 deletions

diff --git a/fml/doc/ja/tutorial/setup/apache.sgml b/fml/doc/ja/tutorial/setup/apache.sgml
index 4b310f0c..58ee7c97 100644
--- a/fml/doc/ja/tutorial/setup/apache.sgml
+++ b/fml/doc/ja/tutorial/setup/apache.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: apache.sgml,v 1.2 2004/10/03 10:55:15 fukachan Exp $
+   $FML: apache.sgml,v 1.3 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -35,7 +35,7 @@ configure を実行する際に、
 configure --enable-suexec --suexec-caller=www
 </screen>
 などとします。
-ここでは suexec を呼ことが可能なユーザが www です。
+ここでは suexec を呼びだすことが可能なユーザが www です。
 このユーザには、この用途専用のものを用意して下さい。
 </para>
 
diff --git a/fml/doc/ja/tutorial/setup/cgi.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml
index 483fb406..1a9bef1b 100644
--- a/fml/doc/ja/tutorial/setup/cgi.sgml
+++ b/fml/doc/ja/tutorial/setup/cgi.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: cgi.sgml,v 1.7 2004/10/06 09:07:42 fukachan Exp $
+   $FML: cgi.sgml,v 1.8 2004/10/27 10:21:58 fukachan Exp $
 -->
 
 
@@ -27,10 +27,10 @@ apache で suexec を使う
 </para>
 
 <para>
-2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI が用
-意されています。このインターフェイスで、ユーザの追加、削除、メンバーリ
-ストやログの閲覧などが可能ですが、CGI からの設定変更インターフェイス(
-config.cf の編集機能)が未実装です。
+現在、ＭＬごとの CGI およびドメイン全体を管理する CGI が用意されていま
+す。このインターフェイスで、ユーザの追加、削除、メンバーリストやログの
+閲覧などが可能ですが、CGI からの設定変更インターフェイス( config.cf の
+編集機能)が中途半端です。
 </para>
 
 <para>
@@ -50,8 +50,7 @@ qmail を使っているなら、CGI 用の特別な「メールサーバの設定変更」は不要
 <para>
 makefml newml を実行するとデフォルトで config.cgi などの CGI スクリプ
 トが ~fml/public_html/ 以下に用意されています。この CGI は二種類あり、
-ドメイン全体を管理する CGI と、それぞれのＭＬを管理する CGI と両方あり
-ます。
+ドメイン全体を管理する CGI と、それぞれのＭＬを管理する CGI があります。
 <screen>
 そのドメインのＭＬ全部の管理者用
 ~fml/public_html/fml/ドメイン/admin/config.cgi
@@ -109,7 +108,8 @@ http://lists.fml.org/~fml/cgi-bin/fml/fml.org/.htaccess
 <footnote>
 <para>
 さらに、デフォルトの apache では ~fml/ へのアクセスは出来ないはずなの
-で、apache の設定も別途必要です。一応、この二段構えになっています。
+で、apache の設定も別途必要です。一応、デフォルトでは、この二段構えの
+拒否体制になっています。
 </para>
 </footnote>
 <screen>
@@ -117,7 +117,8 @@ AuthName ByPassword
 AuthType Basic
 require valid-user
 </screen>
-この .htaccess を適切なものに書き換えて下さい。
+この .htaccess を適切なものに書き換え、
+apache の設定で suexec を有効にして下さい。
 <screen>
 例
 
@@ -130,7 +131,7 @@ require valid-user
 
 <warning>
 <para>
-(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになりま
+(当たり前ですが)このファイルを消すと、誰でもアクセスできるようになりま
 す。デバッグする場合はともかく、そういう裏技は使わないようにしましょう;-)
 また、そういうデバッグなんて時に限って、そのまま再設定し忘れたりするも
 のなので、しない方が良いです。きちんと .htaccess を設定しましょう。
diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml
index 4c06a4d7..8d60d17c 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.4 2004/04/07 11:07:11 fukachan Exp $
+   $FML: config.cf.sgml,v 1.5 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -12,7 +12,7 @@
 makefml は、
 makefml newml を実行した際に、
 そのＭＬの config.cf などの設定ファイル群を一式を作り、
-さらに、MTA が fml を起動する際に使う include 類( postfix 用)および
+さらに MTA が fml を起動する際に使う include 類( postfix 用)および
 ~fml/.qmail-* ( qmail 用 )
 などの必要な設定ファイル一式を用意します。
 <screen>
@@ -28,7 +28,7 @@ config.cf include include-ctl include-error
 <warning>
 
 <para>
-現状、設定支援ツールがまだないので、ＭＬのカスタマイズは config.cf を
+現状、設定支援ツールが未完成なので、ＭＬのカスタマイズは config.cf を
 エディタで編集して下さい。
 </para>
 
@@ -36,8 +36,8 @@ config.cf include include-ctl include-error
 
 <para>
 makefml newml が作る config.cf には、ほとんど何も定義されていません。
-config.cf の先頭の ml_domain と ml_name もコメントになっていますが、そ
-れらはコマンドの引数から自動的に決定されます。
+config.cf の先頭の ml_domain と ml_name もコメントになっていますが、
+それらはコマンドの引数から自動的に決定されるのでコメントでよいのです。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
index 1cdec728..932de0b1 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.4 2004/04/07 11:07:11 fukachan Exp $
+   $FML: merge.fml4to8.sgml,v 1.5 2004/12/23 14:59:51 fukachan Exp $
 -->
 
 
@@ -20,7 +20,9 @@
 <link linkend="mergeml.fml4.overview">
 fml4 の fml.pl を fml8 の fml.pl と入れ換え可能
 </link>
-としました。
+としました。つまり、fml8 による fml4 の直接エミュレーションです。これ
+は fml4 の fml.pl を fml8 の fml.pl に入れ換えるだけで 4 から 8 へのアッ
+プグレードを可能にしようとするものです。
 </para>
 
 
@@ -30,19 +32,25 @@ fml4 の fml.pl を fml8 の fml.pl と入れ換え可能
 	</title>
 
 <para>
-要するに fml4 から fml8 への移行ということですが、fml4 の実行ファイル
-を fml8 で上書きすれば、そのまま動くようにはなっていません。
+要するに fml4 から fml8 への移行ということですが、「fml4 の実行ファイ
+ルを fml8 で上書きすれば、そのまま動く」というわけではありません。
 </para>
 
 <para>
-上書きしてしまうと、一斉に移行を強制することになるし、失敗した時が痛過
-ぎます。やっぱり、少しずつ移行していきたいよね？また、少しずつ移行する
-場合にも、出来れば、逆戻りができたほうがいいでしょう。
+今の fml8 では、それに近いことも出来ますが、その際にも、設定ファイルの
+自動変換などバックグラウンドで色々な処理が行なわれています。
+</para>
+
+<para>
+そもそも 4 を 8 で上書きしてしまうと、一斉に移行を強制することになるし、
+失敗した時のエラーリカバリが大変です。やはり、少しずつ移行していきたい
+でしょう。また、少しずつ移行する場合にも、出来れば、逆戻りができたほう
+がいいでしょう。
 </para>
 
 <para>
 そんなわけで、ＭＬ一つ一つを移行できるような仕組みにしておきたい。
-できれば、リカバリも出来ると良いです。
+できれば、リカバリも出来ると良いとおもいます。
 </para>
 
 <para>
@@ -74,7 +82,7 @@ aliases や include の自動変換は、makefml mergeml コマンドが頑張ります。
 </para>
 
 <para>
-さすがに、難しい設定がてんこ盛りのconfig.phは無理ですが、簡単な
+さすがに、難しい設定がてんこ盛りの config.ph は無理ですが、簡単な
 config.ph であれば、fml8 の config.cf へ全自動で変換できる予定です。な
 お、簡単な config.ph とは、たとえば、Subjectのタグと投稿制限の設定など
 の、makefml config (メニュー)で設定変更ができたレベルのものを想定して
@@ -266,8 +274,8 @@ aliasesとincludeファイルについての説明をしておきます。
 </para>
 
 <para>
-起動された distribute コマンドは、config.cfを読み込み、config.cfからメ
-ンバーリストなどの場所を知り、さまざまな処理を行なうといった具合です。
+起動された distribute コマンドは、config.cf を読み込み、config.cf から
+メンバーリストなどの場所を知り、さまざまな処理を行なうといった具合です。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml
index 41f2f1ab..a257a05d 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.7 2004/04/07 11:07:11 fukachan Exp $
+   $FML: newml.sgml,v 1.8 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -18,19 +18,23 @@
 <para>
 デフォルトドメインの場合、&fml4 と同じで構いません。
 バーチャルドメインを使う場合、ちょっと違います。
-次節を参照して下さい。
+バーチャルドメインについては
+<link linkend="setup.newml.nondefault">
+<xref linkend="setup.newml.nondefault">
+</link>
+を参照して下さい。
 </para>
 </caution>
 
 <para>
-makefml を使ってＭＬを作成します。
+ＭＬの作成は makefml を使って行ないます。
 使い方は &fml4; と同様です。
 <screen>
 % su fml
 % makefml newml elena
    ... 処理の様子が出力される(略) ...
 </screen>
-デフォルトの/var/spool/ml以外にパスを切替えたい場合は
+デフォルトの /var/spool/ml 以外のパスを使いたい場合は
 makefml newdomain コマンドでパスを指定して下さい。
 <screen>
 % su root
@@ -45,7 +49,7 @@ makefml newdomain コマンドでパスを指定して下さい。
 
 
 <para>
-この時、makefml newml は以下のような処理をします。
+makefml newml は実行時、次のような処理を行ないます。
 
 <itemizedlist>
 
@@ -57,7 +61,7 @@ makefml newdomain コマンドでパスを指定して下さい。
 	include
 	include-ctl
 	</screen>
-	などを作る(適宜、elena やドメインの値を変換しながら)
+	などを作る(適宜、elena やドメインの値を変換しながら)。
         </para>
    </listitem>
 
@@ -131,50 +135,56 @@ makefml newdomain コマンドでパスを指定して下さい。
 </caution>
 
 <para>
-makefml を使ってＭＬを作成します。
-使い方は &fml4; と同様ですが、ＭＬ名にきちんとドメインまでつけて下さい。
+ＭＬを作成には makefml を使います。
+使い方は &fml4; と同様です。
+しかしながらＭＬ名にきちんとドメインまでつけるところが異なります。
+注意して下さい。
+</para>
+
+<para>
+初回は newdomain コマンドによるドメイン定義も必要です。
 <screen>
-初回は、newdomain コマンドによるドメイン定義も必要です。
 % su root
 # makefml newdomain nuinui.net /var/spool/virtual/nuinui.net
 # exit
 % su fml
 % makefml newml elena@nuinui.net
-
+</screen>
 二回目以降の場合は
-
+<screen>
 % su fml
 % makefml newml elena@nuinui.net
-
-だけでよいです。
 </screen>
+だけでかまいません。
 </para>
 
 <para>
 newdomainコマンドでは、ドメインと使う ml_home_prefix ディレクトリのペ
 アを指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファ
-イルの編集を代行します。上の例では ml_home_prefix ファイルに次の行を追
-加します。
+イルの編集を代行します。上の例では ml_home_prefix ファイルに次の行が追
+加されます。
 <screen>
 nuinui.net /var/spool/virtual/nuinui.net
 </screen>
-ちなみに、消す場合は rmdomain コマンドです。
+ちなみに、この対応関係を消す場合は rmdomain コマンドです。
 </para>
 
 <para>
-newml コマンドは引数のＭＬ名をドメイン名つきにする以外、デフォルトドメ
-インの場合と同じです。
+newml コマンドは、引数のＭＬ名をドメイン名つきにする以外、デフォルトド
+メインの場合と操作方法は同じです。
 </para>
 
 <para>
-また、バーチャルドメインの場合は、各 MTA ごとのバーチャルドメインの設
-定見本を作ります。
+また、バーチャルドメインの場合、makefml newml は各 MTA ごとのバーチャ
+ルドメイン用設定見本を作ります。たとえば
 <screen>
 /var/spool/ml/etc/sendmail/virtusertable
 /var/spool/ml/etc/postfix/virtual
 </screen>
-注: 
-qmail や procmail にはバーチャル用の設定が特にあるわけではありません。
+が作られます。
+qmail 用の見本は作られません。
+な procmail は.procmailrcの見本がドメイン名つきなので別途バーチャル用
+という設定はありません。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/postfix.sgml b/fml/doc/ja/tutorial/setup/postfix.sgml
index 27947294..a68f6109 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.3 2003/04/15 14:51:44 fukachan Exp $
+   $FML: postfix.sgml,v 1.4 2004/04/07 11:07:12 fukachan Exp $
 -->
 
 <sect1 id="setup.postfix.aliases">
@@ -26,7 +26,7 @@ postfix の設定については
 
 <para>
 makefml はシステムの aliases (例: /etc/mail/aliases)を変更することはあ
-りません。各ドメインごとにある alias ファイル 
+りません。各ドメインごとに用意されている 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 0aaacf34..9b8df9af 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.4 2004/04/07 11:07:12 fukachan Exp $
+   $FML: procmail.sgml,v 1.5 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -64,4 +64,23 @@ inbox/.
 
 </sect2>
 
+<sect2>
+	<title>
+	バーチャルドメインの場合
+	</title>
+
+<para>
+上の例で分かるようにドメイン名つきのルールが記述されているので、
+procmail の設定でバーチャルドメインか否かは関係ありません。
+よって、特別な設定はありません。
+</para>
+
+<para>
+もっとも、別途、バーチャルドメイン宛のメールをユーザ fml さんに転送す
+る設定が MTA に必要なのですが、それは ISP なりメールサーバの管理者が行
+なってくれる必要があります。
+</para>
+
+</sect2>
+
 </sect1>
diff --git a/fml/doc/ja/tutorial/setup/qmail.sgml b/fml/doc/ja/tutorial/setup/qmail.sgml
index 67708a5a..31b1e49c 100644
--- a/fml/doc/ja/tutorial/setup/qmail.sgml
+++ b/fml/doc/ja/tutorial/setup/qmail.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: qmail.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $
+   $FML: qmail.sgml,v 1.3 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -31,4 +31,22 @@ fml.org:fml-fml.org
 </para>
 </warning>
 
+<sect2>
+	<title>
+	バーチャルドメインの場合
+	</title>
+
+<para>
+makefml newml を実行するだけで自動的にＭＬが有効になるようにするには
+/var/qmail/control/virtualdomains
+に設定が必要です。しかしながら、このファイルは通常ユーザ fml さんには
+編集する権限がないので、ＭＬ管理者が設定を追加して下さい。
+<screen>
+ドメイン:fml-ドメイン
+</screen>
+この追加は全てのドメイン分必要なことに注意して下さい。
+</para>
+
+</sect2>
+
 </sect1>
diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml
index 8750ed00..f155e053 100644
--- a/fml/doc/ja/tutorial/setup/test.sgml
+++ b/fml/doc/ja/tutorial/setup/test.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: test.sgml,v 1.5 2004/04/07 11:07:12 fukachan Exp $
+   $FML: test.sgml,v 1.6 2004/10/06 09:07:42 fukachan Exp $
 -->
 
 
@@ -28,10 +28,9 @@
 
 <warning>
 <para>
-テストの前に
-newml の際のユーザ重複チェックを効かせるために
-postfix の aliases をきちんと追加して下さい。
-これをしないと root ＭＬとか作れちゃいます:-)
+newml の際のユーザ重複チェックを効かせるため、
+テストの前に postfix の aliases をきちんと追加して下さい。
+これをしないと root ＭＬとかが作れてしまいます;-)
 </para>
 
 <para>
@@ -54,8 +53,8 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 	</title>
 
 <para>
-ＭＬの動作テストの前に、ahodori.fml.org のメールサーバ自体がきちんと動
-作していることを確認して下さい。
+ＭＬの動作テストの前に、メールサーバ(ここでは ahodori.fml.org とする)
+自体がきちんと動作していることを確認して下さい。
 </para>
 
 <para>
@@ -69,24 +68,25 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 </para>
 
 <para>
-まず、メールサーバ以外のホストから rudo@fml.org へメールが届くか？(到
-達性)を確認して下さい。つまり、メールサーバ以外のホストから
-rudo@fml.org くんにメールを出し、ちゃんと受信できているかを確認してく
-ださい。もし受けとれないなら、そもそも Postfix の設定が間違っています。
-</para>
-
-<para>
-次に、そのホスト上で rudo くんにメールが届くかも試して下さい。
+まず、そのホスト上で rudo くんにメールが届くかも試して下さい。
 つまり ahodori の上で rudo@fml.org へメールを出してください。
 <screen>
 % echo test |Mail rudo@fml.org
 </screen>
-この場合も、
 もし受けとれないなら、そもそも Postfix の設定が間違っています。
 </para>
 
 <para>
-Postfix の基本設定が正しいと確認できたらＭＬのテストに進んで下さい。
+次に、メールサーバ以外のホストから rudo@fml.org へメールが届くか？(到
+達性)を確認して下さい。つまり、メールサーバ以外のホストから
+rudo@fml.org くんにメールを出し、ちゃんと受信できているかを確認してく
+ださい。もし受けとれないなら、そもそも Postfix の設定が間違っています。
+</para>
+
+<para>
+少なくとも、この二点のパターンが動作するならPostfix の基本設定が正しい
+といえるでしょう。Postfix の基本設定が確認できたらＭＬのテストに進んで
+下さい。
 </para>
 
 </sect1>
@@ -150,6 +150,10 @@ fml8 には、今のところ、それに相当するものはありません。
 作らなきゃ…
 </para>
 
+<!--
+	XXX-TODO: makefml test コマンド
+-->
+
 </sect1>