bug fix GUI setup.

add comments on apache suexec installation.

4 files changed, 97 insertions, 10 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 305a51b7..1ebd0195 100644
--- a/fml/doc/ja/tutorial/book.sgml
+++ b/fml/doc/ja/tutorial/book.sgml
@@ -2,7 +2,7 @@
 This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
 to generate various output formats.
 
-$FML: book.sgml,v 1.65 2004/04/02 04:53:39 fukachan Exp $
+$FML: book.sgml,v 1.66 2004/04/07 11:01:28 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -66,6 +66,7 @@ $FML: book.sgml,v 1.65 2004/04/02 04:53:39 fukachan Exp $
 
 	<!-- CGI -->
 	&chapter.setup.cgi;
+	&chapter.setup.apache;
 
 	<!-- テスト -->
 	&chapter.setup.test;
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 80f283b1..61b62c3f 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.88 2004/05/19 13:18:00 fukachan Exp $
+	$FML: chapters.ent,v 1.89 2004/05/28 05:03:37 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -45,6 +45,7 @@
 <!entity sect.setup.qmail         SYSTEM "setup/qmail.sgml">
 <!entity sect.setup.config.cf     SYSTEM "setup/config.cf.sgml">
 <!entity sect.setup.newml.recipes SYSTEM "setup/newml.recipes.sgml">
+<!entity chapter.setup.apache     SYSTEM "setup/apache.sgml">
 <!entity chapter.setup.cgi        SYSTEM "setup/cgi.sgml">
 <!entity chapter.setup.test       SYSTEM "setup/test.sgml">
 <!entity chapter.merge.fml4to8    SYSTEM "setup/merge.fml4to8.sgml">
diff --git a/fml/doc/ja/tutorial/setup/apache.sgml b/fml/doc/ja/tutorial/setup/apache.sgml
new file mode 100644
index 00000000..cfd513be
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/apache.sgml
@@ -0,0 +1,67 @@
+<!--
+   $FML$
+-->
+
+
+<chapter id="setup.apache">
+	<title>
+	apache の設定
+	</title>
+
+
+<warning>
+
+<para>
+fml8 CGI の内部構造については
+<link linkend="cgi.internal.method">
+<xref linkend="cgi.internal.method">
+</link>
+を参照して下さい。
+</para>
+
+</warning>
+
+
+<sect id="setup.apache.suexec">
+	<title>
+	apache で suexec を使う
+	</title>
+
+<para>
+suexec 利用可能な apache を作る必要があります。 
+configure を実行する際に、
+<screen>
+configure --enable-suexec --suexec-caller=www
+</screen>
+などとします。
+ここでは suexec を呼ことが可能なユーザが www です。
+このユーザには、この用途専用のものを用意して下さい。
+</para>
+
+<para>
+インストール後、~ユーザ/cgi-bin/ を許すように httpd.conf を
+設定する必要があります。
+<screen>
+&lt;Directory /home/*/*/public_html&gt;
+    AllowOverride FileInfo AuthConfig Limit
+    Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec ExecCGI
+    &lt;Limit GET POST OPTIONS PROPFIND&gt;
+        Order allow,deny
+        Allow from 特定のホスト
+    &lt;/Limit&gt;
+&lt;/Directory&gt;
+
+&lt;IfModule mod_mime.c&gt;
+	... 略 ...
+
+   AddHandler cgi-script .cgi
+
+	... 略 ...
+&lt;/IfModule&gt;
+</screen>
+</para>
+
+</sect1>
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/setup/cgi.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml
index 3df37494..d0fdefd3 100644
--- a/fml/doc/ja/tutorial/setup/cgi.sgml
+++ b/fml/doc/ja/tutorial/setup/cgi.sgml
@@ -1,7 +1,8 @@
 <!--
-   $FML: cgi.sgml,v 1.4 2003/04/15 14:51:43 fukachan Exp $
+   $FML: cgi.sgml,v 1.5 2004/03/31 06:29:00 fukachan Exp $
 -->
 
+
 <chapter id="setupcgi">
 	<title>
 	CGI の設定
@@ -19,18 +20,20 @@ CGI の内部構造については
 </para>
 
 <para>
-apache で suexec を使うことを前提としています。
+<link linkend="setup.apache.suexec">apache で suexec を使う</link>
+ことを前提としています。
 </para>
 
 <para>
-また、現在はＭＬごとの CGI はなく、
-ドメイン全体を管理する CGI しかありません。
-そのうち作ります _o_ 
+2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI は、
+あります。ユーザの追加、削除、メンバーリストやログの閲覧などが可能です
+が、CGI からの設定変更インターフェイス( config.cf の編集機能)が未実装
+です。
 </para>
 
 <para>
-CGI を使う場合でも、メールサーバとして postfix や qmail を使っている場
-合はメールサーバの設定変更は不要です。
+なお、CGI を使う場合でも、メールサーバとして postfix や qmail を使って
+いるなら、CGI 用の特別な「メールサーバの設定変更」は不要です。
 </para>
 
 </warning>
@@ -38,7 +41,7 @@ CGI を使う場合でも、メールサーバとして postfix や qmail を使っている場
 
 <sect1 id="setupcgi.install">
 	<title>
-	makefml newml は CGI スクリプトを作ります
+	いつでも makefml newml は CGI スクリプトを作っています
 	</title>
 
 <para>
@@ -46,6 +49,13 @@ makefml newml を実行するとデフォルトで config.cgi などの CGI スクリプ
 トが ~fml/public_html/ 以下に用意されています。この CGI は二種類あり、
 ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方ありま
 す。
+<screen>
+そのドメインのＭＬ全部の管理者用
+~fml/public_html/fml/ドメイン/admin/config.cgi
+
+ＭＬごとの管理者用
+~fml/public_html/fml/ドメイン/ml-admin/config.cgi
+</screen>
 </para>
 
 <para>
@@ -100,6 +110,14 @@ AuthType Basic
 require valid-user
 </screen>
 この .htaccess を適切なものに書き換えて下さい。
+<screen>
+例
+
+AuthName ByPassword
+AuthType Basic
+AuthUserConfig "/usr/local/etc/fml/ドメイン/htpasswd"
+require valid-user
+</screen>
 </para>
 
 <warning>