overhaul:

o clean up
o minor bug fixes

8 files changed, 67 insertions, 43 deletions

diff --git a/fml/doc/ja/tutorial/setup/apache.sgml b/fml/doc/ja/tutorial/setup/apache.sgml
index 323a3b92..4b310f0c 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.1 2004/10/02 14:29:46 fukachan Exp $
+   $FML: apache.sgml,v 1.2 2004/10/03 10:55:15 fukachan Exp $
 -->
 
 
@@ -31,6 +31,7 @@ fml8 CGI の内部構造については
 suexec 利用可能な apache を作る必要があります。 
 configure を実行する際に、
 <screen>
+(apache 1.x の場合)
 configure --enable-suexec --suexec-caller=www
 </screen>
 などとします。
@@ -40,8 +41,10 @@ configure --enable-suexec --suexec-caller=www
 
 <para>
 インストール後、~ユーザ/cgi-bin/ を許すように httpd.conf を
-設定する必要があります。
+変更する必要があります。
 <screen>
+設定例:
+
 &lt;Directory /home/*/*/public_html&gt;
     AllowOverride FileInfo AuthConfig Limit
     Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec ExecCGI
diff --git a/fml/doc/ja/tutorial/setup/cgi.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml
index d0fdefd3..571bc298 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.5 2004/03/31 06:29:00 fukachan Exp $
+   $FML: cgi.sgml,v 1.6 2004/10/02 14:29:46 fukachan Exp $
 -->
 
 
@@ -20,20 +20,23 @@ CGI の内部構造については
 </para>
 
 <para>
-<link linkend="setup.apache.suexec">apache で suexec を使う</link>
+<link linkend="setup.apache.suexec">
+apache で suexec を使う
+</link>
 ことを前提としています。
 </para>
 
 <para>
-2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI は、
-あります。ユーザの追加、削除、メンバーリストやログの閲覧などが可能です
-が、CGI からの設定変更インターフェイス( config.cf の編集機能)が未実装
-です。
+2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI が用
+意されています。このインターフェイスで、ユーザの追加、削除、メンバーリ
+ストやログの閲覧などが可能ですが、CGI からの設定変更インターフェイス(
+config.cf の編集機能)が未実装です。
 </para>
 
 <para>
-なお、CGI を使う場合でも、メールサーバとして postfix や qmail を使って
-いるなら、CGI 用の特別な「メールサーバの設定変更」は不要です。
+なお、CGI から設定変更を行なう場合でも、メールサーバとして postfix や 
+qmail を使っているなら、CGI 用の特別な「メールサーバの設定変更」は不要
+です。
 </para>
 
 </warning>
@@ -41,14 +44,14 @@ CGI の内部構造については
 
 <sect1 id="setupcgi.install">
 	<title>
-	いつでも makefml newml は CGI スクリプトを作っています
+	いつでも makefml newml は CGI スクリプトを作ります
 	</title>
 
 <para>
 makefml newml を実行するとデフォルトで config.cgi などの CGI スクリプ
 トが ~fml/public_html/ 以下に用意されています。この CGI は二種類あり、
-ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方ありま
-す。
+ドメイン全体を管理する CGI と、それぞれのＭＬを管理する CGI と両方あり
+ます。
 <screen>
 そのドメインのＭＬ全部の管理者用
 ~fml/public_html/fml/ドメイン/admin/config.cgi
@@ -74,8 +77,7 @@ http://lists.fml.org/~fml/cgi-bin/fml/ドメイン/ml-admin/ＭＬ名/config.cgi
 例
 http://lists.fml.org/~fml/cgi-bin/fml/fml.org/ml-admin/elena/config.cgi
 </screen>
-の両方が makefml により用意されます
-(後者はそういう予定ということで、実際には作られません _o_)。
+の両方が makefml により用意されます。
 </para>
 
 <para>
@@ -104,6 +106,12 @@ http://lists.fml.org/~fml/cgi-bin/fml/fml.org/.htaccess
 <para>
 デフォルトの .htaccess は次のような無意味:)なものになっていて、
 アクセスできません。
+<footnote>
+<para>
+さらに、デフォルトの apache では ~fml/ へのアクセスは出来ないはずなの
+で、apache の設定も別途必要です。一応、この二段構えになっています。
+</para>
+</footnote>
 <screen>
 AuthName ByPassword
 AuthType Basic
@@ -122,10 +130,10 @@ require valid-user
 
 <warning>
 <para>
-(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになります。
-デバッグする場合はともかく、そういう裏技は使わないようにしましょう;-)
-また、そういうのに限って再設定し忘れたりするものなので、しない方が良い
-です。きちんと .htaccess を設定しましょう。
+(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになりま
+す。デバッグする場合はともかく、そういう裏技は使わないようにしましょう;-)
+また、そういうデバッグなんて時に限って、そのまま再設定し忘れたりするも
+のなので、しない方が良いです。きちんと .htaccess を設定しましょう。
 </para>
 </warning>
 
diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml
index 88ee08da..4c06a4d7 100644
--- a/fml/doc/ja/tutorial/setup/config.cf.sgml
+++ b/fml/doc/ja/tutorial/setup/config.cf.sgml
@@ -1,7 +1,8 @@
 <!--
-   $FML: config.cf.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $
+   $FML: config.cf.sgml,v 1.4 2004/04/07 11:07:11 fukachan Exp $
 -->
 
+
 <sect1 id="setup.config.cf">
 	<title>
 	設定ファイル config.cf のカスタマイズ
@@ -11,8 +12,9 @@
 makefml は、
 makefml newml を実行した際に、
 そのＭＬの config.cf などの設定ファイル群を一式を作り、
-さらに、MTA がfml を起動する際に使う include 類( postfix 用)および~
-fml/.qmail-* ( qmail 用)など必要な設定ファイル一式を用意します。
+さらに、MTA が fml を起動する際に使う include 類( postfix 用)および
+~fml/.qmail-* ( qmail 用 )
+などの必要な設定ファイル一式を用意します。
 <screen>
 % su fml
 % makefml newml elena
@@ -43,15 +45,15 @@ config.cf の先頭の ml_domain と ml_name もコメントになっていますが、そ
 <screen>
 "| /usr/local/libexec/fml/distribute elena@fml.org"
 </screen>
-そして、/var/spool/ml/elena/include-ctl ファイルは
+そして /var/spool/ml/elena/include-ctl ファイルは
 <screen>
 "| /usr/local/libexec/fml/command elena@fml.org"
 </screen>
-などとなっています。MTAから起動された 
+などとなっています。MTA から起動された 
 /usr/local/libexec/fml/distribute
-コマンドなどが、このコマンド引数の elena@fml.org の部分からml_domain 
-と ml_name を自動的に設定します。そのため config.cf ではコメントのまま
-で問題ありません。
+コマンドなどが、このコマンド引数の elena@fml.org の部分から
+ml_domain と ml_name を自動的に設定します。
+そのため config.cf ではコメントのままで問題ありません。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/newml.recipes.sgml b/fml/doc/ja/tutorial/setup/newml.recipes.sgml
index 8dc4c5da..587b25f5 100644
--- a/fml/doc/ja/tutorial/setup/newml.recipes.sgml
+++ b/fml/doc/ja/tutorial/setup/newml.recipes.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: newml.recipes.sgml,v 1.1 2003/12/21 03:19:14 fukachan Exp $
+   $FML: newml.recipes.sgml,v 1.2 2004/04/07 11:07:11 fukachan Exp $
 -->
 
 
@@ -33,7 +33,7 @@ $newml_command_ml_admin_default_address
 デフォルトでは、どのＭＬでも /usr/local/etc/fml/main.cf で定義されてい
 る管理者のアドレス $fml_owner が使われます。
 
-それ以外のものにしたい場合、
+それ以外のものにしたい場合、site_default_config.cf で
 $newml_command_ml_admin_default_address 
 にメールアドレスを設定して下さい。
 <screen>
diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml
index c7475235..41f2f1ab 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.6 2003/12/21 03:19:14 fukachan Exp $
+   $FML: newml.sgml,v 1.7 2004/04/07 11:07:11 fukachan Exp $
 -->
 
 
@@ -134,19 +134,27 @@ makefml newdomain コマンドでパスを指定して下さい。
 makefml を使ってＭＬを作成します。
 使い方は &fml4; と同様ですが、ＭＬ名にきちんとドメインまでつけて下さい。
 <screen>
+初回は、newdomain コマンドによるドメイン定義も必要です。
 % su root
 # makefml newdomain nuinui.net /var/spool/virtual/nuinui.net
 # exit
 % su fml
 % makefml newml elena@nuinui.net
+
+二回目以降の場合は
+
+% su fml
+% makefml newml elena@nuinui.net
+
+だけでよいです。
 </screen>
 </para>
 
 <para>
-newdomainコマンドでは、ドメインと使うml_home_prefixディレクトリのペア
-を指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファイ
-ルの編集を代行します。上の例では ml_home_prefix ファイルに次の行を追加
-します。
+newdomainコマンドでは、ドメインと使う 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/procmail.sgml b/fml/doc/ja/tutorial/setup/procmail.sgml
index ad5cf285..0aaacf34 100644
--- a/fml/doc/ja/tutorial/setup/procmail.sgml
+++ b/fml/doc/ja/tutorial/setup/procmail.sgml
@@ -1,7 +1,8 @@
 <!--
-   $FML: procmail.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $
+   $FML: procmail.sgml,v 1.4 2004/04/07 11:07:12 fukachan Exp $
 -->
 
+
 <sect1 id="setup.procmail">
 	<title>
 	自分のアカウントでＭＬを行ないたい
@@ -20,10 +21,10 @@
 </para>
 
 <para>
-こういった場合、&fmldevel; ではユーザが procmail などの振分ツールを使
-うだろうと期待しています:-)そのため、&fmldevel; に振り分けツールは用意
-されていません。OS のパッケージシステムなどを使って振り分けツールをイ
-ンストールして下さい。
+こういった場合、&fml8; ではユーザが procmail などの振分ツールを使うだ
+ろうと期待しています:-)そのため、&fml8; に振り分けツールは用意されてい
+ません。OS のパッケージシステムなどを使って振り分けツールをインストー
+ルして下さい。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/setup/qmail.sgml b/fml/doc/ja/tutorial/setup/qmail.sgml
index 48b06f59..67708a5a 100644
--- a/fml/doc/ja/tutorial/setup/qmail.sgml
+++ b/fml/doc/ja/tutorial/setup/qmail.sgml
@@ -1,7 +1,8 @@
 <!--
-   $FML$
+   $FML: qmail.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $
 -->
 
+
 <sect1 id="setup.qmail.aliases">
 	<title>
 	メールサーバの設定 (qmail)
diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml
index 8abd2797..8750ed00 100644
--- a/fml/doc/ja/tutorial/setup/test.sgml
+++ b/fml/doc/ja/tutorial/setup/test.sgml
@@ -1,7 +1,8 @@
 <!--
-   $FML: test.sgml,v 1.4 2003/04/15 14:51:44 fukachan Exp $
+   $FML: test.sgml,v 1.5 2004/04/07 11:07:12 fukachan Exp $
 -->
 
+
 <chapter id="test">
 	<title>
 	テスト
@@ -28,7 +29,7 @@
 <warning>
 <para>
 テストの前に
-newml の際の重複チェックを効かせるために
+newml の際のユーザ重複チェックを効かせるために
 postfix の aliases をきちんと追加して下さい。
 これをしないと root ＭＬとか作れちゃいます:-)
 </para>
@@ -59,7 +60,7 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 
 <para>
 まず、メールサーバに個人宛のメールアドレスを用意しましょう。
-ここでは、ユーザるどくん rudo@fml.org とします。
+ここでは、ユーザ「るど」くん rudo@fml.org を例にとります。
 <footnote>
 <para>
 簡単に用意するには、ユーザ rudo くんを作ればよいでしょう。