clean up CGI a few

3 files changed, 58 insertions, 24 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index b3724e1c..561357de 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.35 2002/07/02 10:39:28 fukachan Exp $
+$FML: book.sgml,v 1.36 2002/07/04 10:58:58 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -61,7 +61,7 @@ $FML: book.sgml,v 1.35 2002/07/02 10:39:28 fukachan Exp $
 	&chapter.upgrade;
 
 	<!-- CGI -->
-	&chapter.setup.cgi.admin;
+	&chapter.setup.cgi;
 
 	<!-- テスト -->
 	&chapter.setup.test;
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 37d614ca..dfca9577 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.37 2002/07/02 10:39:34 fukachan Exp $
+	$FML: chapters.ent,v 1.38 2002/07/04 10:58:59 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -40,7 +40,7 @@
 <!entity sect.setup.postfix       SYSTEM "setup/postfix.sgml">
 <!entity sect.setup.qmail         SYSTEM "setup/qmail.sgml">
 <!entity sect.setup.config.cf     SYSTEM "setup/config.cf.sgml">
-<!entity chapter.setup.cgi.admin  SYSTEM "setup/cgi.admin.sgml">
+<!entity chapter.setup.cgi        SYSTEM "setup/cgi.sgml">
 <!entity chapter.setup.test       SYSTEM "setup/test.sgml">
 
 
diff --git a/fml/doc/ja/tutorial/setup/cgi.admin.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml
index 3bfee028..d1b0d1ce 100644
--- a/fml/doc/ja/tutorial/setup/cgi.admin.sgml
+++ b/fml/doc/ja/tutorial/setup/cgi.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML: cgi.admin.sgml,v 1.2 2002/07/04 15:27:26 fukachan Exp $
+   $FML: cgi.admin.sgml,v 1.3 2002/07/04 15:56:24 fukachan Exp $
 -->
 
 <chapter id="setup.cgi">
 	<title>
-	ドメインマスタ CGI の設定
+	CGI の設定
 	</title>
 
 
@@ -20,37 +20,41 @@
 <para>
 apache で suexec を使うことを前提としています。
 </para>
+
+<para>
+また、現在はドメイン全体を管理する CGI しかありません。
+</para>
+
+<para>
+CGI を使う場合でも、メールサーバとして postfix や qmail を使っている場
+合はメールサーバの設定変更は不要です。
+</para>
+
 </warning>
 
 
-<sect1 id="setup.cgi.overview">
+<sect1 id="setup.cgi.install">
 	<title>
-	makefml newml は CGI を用意する
+	makefml newml は CGI スクリプトを作ります
 	</title>
 
 <para>
-makefml newml を実行すると
-CGI による設定ツールがデフォルトで用意されています。
-この CGI は二種類あり、
-ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方あります。
+makefml newml を実行するとデフォルトで config.cgi などの CGI スクリプ
+トが ~fml/public_html/ 以下に用意されています。この CGI は二種類あり、
+ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方ありま
+す。
 </para>
 
-<warning>
-<para>
-現在はドメイン全体を管理する CGI しかありません。
-</para>
-</warning>
-
 <para>
 例えば、elena@fml.org ＭＬを作成すると
-fml.org の全ＭＬを管理する CGI
+fml.org の全ＭＬを管理する CGI スクリプト
 <screen>
 http://lists.fml.org/~fml/cgi-bin/fml/ドメイン/admin/config.cgi
 
 例
 http://lists.fml.org/~fml/cgi-bin/fml/fml.org/admin/config.cgi
 </screen>
-と elena ML だけを管理する CGI
+と elena ML だけを管理する CGI スクリプト
 <screen>
 http://lists.fml.org/~fml/cgi-bin/fml/ドメイン/ml-admin/ＭＬ名/config.cgi
 
@@ -60,15 +64,44 @@ http://lists.fml.org/~fml/cgi-bin/fml/fml.org/ml-admin/elena/config.cgi
 の両方が makefml により用意されます。
 </para>
 
+</sect1>
+
+
+<sect1 id="setup.cgi.htaccess">
+	<title>
+	.htaccess を編集する
+	</title>
+
 <para>
-デフォルトでは、
+デフォルトでは、CGI のアクセスを拒否するようにドメイン単位で
+.htaccess が作られます。
 <screen>
+http://lists.fml.org/~fml/cgi-bin/fml/ドメイン/.htaccess
+
+例
 http://lists.fml.org/~fml/cgi-bin/fml/fml.org/.htaccess
 </screen>
-というファイルが作られ、アクセス制限がかかっています。
+</para>
+
+<para>
+デフォルトの .htaccess は次のような無意味なものになっています:)
+<screen>
+AuthName ByPassword
+AuthType Basic
+require valid-user
+</screen>
 この .htaccess を適切なものに書き換えて下さい。
 </para>
 
+<warning>
+<para>
+(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになります。
+デバッグするならいいけど、そういうことはしないように;-)
+でもそういうのに限って再設定し忘れたりするものなので、
+しない方が良いです。
+</para>
+</warning>
+
 </sect1>
 
 
@@ -89,6 +122,7 @@ makefml のすべての機能が使えるわけでもありません。
 <para>
 画面を見るとわかる通り、
 CGI で可能な項目は makefml のサブセットとなっています。
+なお、使用可能なコマンドは最初の画面にヘルプとして表示されています。
 <screen>
 例: CGI トップ画面
 
@@ -127,7 +161,7 @@ options Language:    list        アドレスリストを見る
 	</title>
 
 <para>
-左の画面のコマンドで newml を選択肢、
+左の画面のコマンドで newml を選択し、
 submit ボタンを押して下さい。
 ML 名を選択する必要はありません:)
 </para>
@@ -146,7 +180,7 @@ ML 名を選択する必要はありません:)
 	</title>
 
 <para>
-左の画面のコマンドで ML 名と subscribe を選択肢、
+左の画面のコマンドで ML 名と subscribe を選択し、
 submit ボタンを押して下さい。
 </para>