From 6f42764133133c8fe661fad0ff85ce9e6dae266f Mon Sep 17 00:00:00 2001
From: fukachan <fukachan>
Date: Thu, 4 Jul 2002 10:58:58 +0000
Subject: sync the first 8 chapters w/ reality, relocate a few, clean up

---
 fml/doc/ja/tutorial/book.sgml                |  22 ++-
 fml/doc/ja/tutorial/include/chapters.ent     |  92 +++++-----
 fml/doc/ja/tutorial/install/download.sgml    |  89 +++++++++
 fml/doc/ja/tutorial/install/fml_on_unix.sgml | 192 ++++++++++++++++++-
 fml/doc/ja/tutorial/install/postfix.sgml     |  52 ++++++
 fml/doc/ja/tutorial/install/qmail.sgml       |  61 +++++++
 fml/doc/ja/tutorial/internals/main.cf.sgml   |  12 +-
 fml/doc/ja/tutorial/overview/fml.sgml        | 144 +++++++++------
 fml/doc/ja/tutorial/overview/ml.sgml         |  16 +-
 fml/doc/ja/tutorial/setup/cgi.admin.sgml     | 147 +++++++++++++++
 fml/doc/ja/tutorial/setup/test.sgml          |   0
 fml/doc/ja/tutorial/usage/cgi.sgml           |  44 -----
 fml/doc/ja/tutorial/usage/newml.sgml         | 264 ---------------------------
 13 files changed, 699 insertions(+), 436 deletions(-)
 create mode 100644 fml/doc/ja/tutorial/install/download.sgml
 create mode 100644 fml/doc/ja/tutorial/install/postfix.sgml
 create mode 100644 fml/doc/ja/tutorial/install/qmail.sgml
 create mode 100644 fml/doc/ja/tutorial/setup/cgi.admin.sgml
 create mode 100644 fml/doc/ja/tutorial/setup/test.sgml
 delete mode 100644 fml/doc/ja/tutorial/usage/cgi.sgml
 delete mode 100644 fml/doc/ja/tutorial/usage/newml.sgml

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 17c565e2..b3724e1c 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.34 2002/04/02 23:16:30 fukachan Exp $
+$FML: book.sgml,v 1.35 2002/07/02 10:39:28 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -52,13 +52,19 @@ $FML: book.sgml,v 1.34 2002/04/02 23:16:30 fukachan Exp $
 
 	<!-- unix -->
 	&chapter.install.fml.unix;
-	&chapter.usage.newml;
+	&chapter.setup.newml;
 
 	<!-- 2000/nt -->
 	&chapter.install.fml.nt;
 
 	<!-- misc around installation/setup -->
 	&chapter.upgrade;
+
+	<!-- CGI -->
+	&chapter.setup.cgi.admin;
+
+	<!-- テスト -->
+	&chapter.setup.test;
   </part>
 
 
@@ -77,9 +83,17 @@ $FML: book.sgml,v 1.34 2002/04/02 23:16:30 fukachan Exp $
 
 	<!-- スレッド追跡システム -->
 	&chapter.threadtrack.usage;
+  </part>
+
+
+  <part>
+	<title> トラブルシューティング </title>
+	<partintro>
+	<para>
+	本パートではトラブルシューティングの話をします。
+	</para>
+	</partintro>
 
-	<!-- 設定ツール -->
-	&chapter.cgi;
   </part>
 
 
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 349b4e05..37d614ca 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.36 2002/05/13 14:16:36 fukachan Exp $
+	$FML: chapters.ent,v 1.37 2002/07/02 10:39:34 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -24,79 +24,83 @@
 
 
 <!-- パート I: introduction 〜 インストール、テストまで -->
-<!entity chapter.overview.fml    SYSTEM "overview/fml.sgml">
-<!entity chapter.overview.ml     SYSTEM "overview/ml.sgml">
-<!entity chapter.download        SYSTEM "overview/download.sgml">
+<!entity chapter.overview.fml     SYSTEM "overview/fml.sgml">
+<!entity chapter.overview.ml      SYSTEM "overview/ml.sgml">
 
 
 <!-- パート II: セットアップ -->
+<!entity chapter.download         SYSTEM "install/download.sgml">
 <!entity chapter.install.fml.unix SYSTEM "install/fml_on_unix.sgml">
 <!entity chapter.install.fml.nt   SYSTEM "install/fml_on_nt.sgml">
+<!entity sect.install.postfix     SYSTEM "install/postfix.sgml">
+<!entity sect.install.qmail       SYSTEM "install/qmail.sgml">
 <!entity chapter.upgrade          SYSTEM "install/upgrade.sgml">
 
+<!entity chapter.setup.newml      SYSTEM "setup/newml.sgml">
+<!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.test       SYSTEM "setup/test.sgml">
+
 
 <!-- パート II: 使い方の例とカスタマイズについて -->
-<!entity chapter.usage.newml     SYSTEM "usage/newml.sgml">
-<!entity chapter.usage.post      SYSTEM "usage/post.sgml">
-<!entity chapter.usage.command   SYSTEM "usage/command.sgml">
-<!entity chapter.usage.onhost    SYSTEM "usage/onhost.sgml">
-<!entity sect.usage.makefml      SYSTEM "usage/makefml.sgml">
-<!entity sect.usage.fmlconf      SYSTEM "usage/fmlconf.sgml">
-<!entity sect.usage.fmldoc       SYSTEM "usage/fmldoc.sgml">
-<!entity sect.usage.fmlthread    SYSTEM "usage/fmlthread.sgml">
-<!entity sect.usage.fmlhtmlify   SYSTEM "usage/fmlhtmlify.sgml">
-<!entity chapter.usage.procmail  SYSTEM "usage/procmail.sgml">
+<!entity chapter.usage.post       SYSTEM "usage/post.sgml">
+<!entity chapter.usage.command    SYSTEM "usage/command.sgml">
+<!entity chapter.usage.onhost     SYSTEM "usage/onhost.sgml">
+<!entity sect.usage.makefml       SYSTEM "usage/makefml.sgml">
+<!entity sect.usage.fmlconf       SYSTEM "usage/fmlconf.sgml">
+<!entity sect.usage.fmldoc        SYSTEM "usage/fmldoc.sgml">
+<!entity sect.usage.fmlthread     SYSTEM "usage/fmlthread.sgml">
+<!entity sect.usage.fmlhtmlify    SYSTEM "usage/fmlhtmlify.sgml">
+<!entity chapter.usage.procmail   SYSTEM "usage/procmail.sgml">
 
 
 <!-- コマンド -->
-<!entity sect.command.internal   SYSTEM "command/internal.sgml">
-<!entity sect.command.extension  SYSTEM "command/extension.sgml">
-<!entity sect.command.module     SYSTEM "command/module.sgml">
-
-
-<!-- 設定ツール: CGI et.al. -->
-<!entity chapter.cgi		 SYSTEM "usage/cgi.sgml">
+<!entity sect.command.internal    SYSTEM "command/internal.sgml">
+<!entity sect.command.extension   SYSTEM "command/extension.sgml">
+<!entity sect.command.module      SYSTEM "command/module.sgml">
 
 
 <!-- う〜ん、分類は…？;-) -->
-<!entity chapter.directory       SYSTEM "internals/directory.sgml">
-<!entity chapter.db              SYSTEM "internals/db.sgml">
-<!entity chapter.dbms            SYSTEM "internals/dbms.sgml">
-<!entity chapter.hook            SYSTEM "internals/hook.sgml">
-<!entity chapter.policy          SYSTEM "policy.sgml">
+<!entity chapter.directory        SYSTEM "internals/directory.sgml">
+<!entity chapter.db               SYSTEM "internals/db.sgml">
+<!entity chapter.dbms             SYSTEM "internals/dbms.sgml">
+<!entity chapter.hook             SYSTEM "internals/hook.sgml">
+<!entity chapter.policy           SYSTEM "policy.sgml">
 
 
 <!-- 配送 -->
-<!entity chapter.delivery        SYSTEM "delivery/chapter.sgml">
+<!entity chapter.delivery         SYSTEM "delivery/chapter.sgml">
 
 
 <!-- 内部構造 -->
-<!entity chapter.bootloader      SYSTEM "internals/bootloader.sgml">
-<!entity sect.main.cf            SYSTEM "internals/main.cf.sgml">
-<!entity chapter.internal.cgi	 SYSTEM "internals/cgi.sgml">
-<!entity chapter.programingstyle SYSTEM "internals/style.sgml">
-<!entity chapter.design          SYSTEM "internals/design.sgml">
-<!entity chapter.config.cf       SYSTEM "internals/config.cf.sgml">
-<!entity chapter.restriction     SYSTEM "internals/restriction.sgml">
+<!entity chapter.bootloader       SYSTEM "internals/bootloader.sgml">
+<!entity sect.main.cf             SYSTEM "internals/main.cf.sgml">
+<!entity chapter.internal.cgi	  SYSTEM "internals/cgi.sgml">
+<!entity chapter.programingstyle  SYSTEM "internals/style.sgml">
+<!entity chapter.design           SYSTEM "internals/design.sgml">
+<!entity chapter.config.cf        SYSTEM "internals/config.cf.sgml">
+<!entity chapter.restriction      SYSTEM "internals/restriction.sgml">
 
 <!-- variables -->
-<!entity table.list.variables    SYSTEM "internals/list.variables.sgml">
+<!entity table.list.variables     SYSTEM "internals/list.variables.sgml">
 
 
 
 <!-- メッセージの取り扱い -->
-<!entity chapter.message         SYSTEM "message/chapter.sgml">
-<!entity sect.message.nl         SYSTEM "message/language.sgml">
-<!entity sect.message.discuss    SYSTEM "message/discussion.sgml">
-<!entity chapter.replybyfml      SYSTEM "message/reply.sgml">
+<!entity chapter.message          SYSTEM "message/chapter.sgml">
+<!entity sect.message.nl          SYSTEM "message/language.sgml">
+<!entity sect.message.discuss     SYSTEM "message/discussion.sgml">
+<!entity chapter.replybyfml       SYSTEM "message/reply.sgml">
 
 
 <!-- 開発 -->
-<!entity chapter.cvstree         SYSTEM "devel/cvstree.sgml">
-<!entity chapter.cvstags         SYSTEM "devel/cvstags.sgml">
-<!entity chapter.docbook         SYSTEM "devel/docbook.sgml">
-<!entity chapter.inet6           SYSTEM "devel/inet6.sgml">
-<!entity chapter.program.create  SYSTEM "devel/create_program.sgml">
+<!entity chapter.cvstree          SYSTEM "devel/cvstree.sgml">
+<!entity chapter.cvstags          SYSTEM "devel/cvstags.sgml">
+<!entity chapter.docbook          SYSTEM "devel/docbook.sgml">
+<!entity chapter.inet6            SYSTEM "devel/inet6.sgml">
+<!entity chapter.program.create   SYSTEM "devel/create_program.sgml">
 
 
 <!-- misc -->
diff --git a/fml/doc/ja/tutorial/install/download.sgml b/fml/doc/ja/tutorial/install/download.sgml
new file mode 100644
index 00000000..cb072fe2
--- /dev/null
+++ b/fml/doc/ja/tutorial/install/download.sgml
@@ -0,0 +1,89 @@
+<!--
+   $FML: download.sgml,v 1.5 2002/07/02 10:39:37 fukachan Exp $
+-->
+
+<chapter id="download">
+	<title>
+	&fmldevel; のソースコードをダウンロードする
+	</title>
+
+
+<!-- ====================================================  -->
+<sect1 id="ftp.fml.org">
+	<title>
+	ftp サーバからダウンロードする。
+	</title>
+
+<para>
+fml-devel のソースは
+	<ulink url="ftp://ftp.fml.org/pub/fml-devel/">
+	ftp://ftp.fml.org/pub/fml-devel/
+	</ulink>
+から、 ftp で入手できます。
+</para>
+
+<para>
+開発の適当な区切りごとに、不定期に作成されています。
+日付の新しいものを選んでダウンロードして下さい。
+</para>
+
+<para>
+なお daily snapshot もあります。
+
+<ulink url="ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/">
+ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/
+</ulink>
+
+全自動で作られているので、特定の日のバージョンはうまく動かないかも知れ
+ません。
+</para>
+
+</sect1>
+
+
+<!-- ====================================================  -->
+<sect1 id="anoncvs">
+	<title>
+	cvs へのアクセス
+	</title>
+
+<para>
+anoncvs.fml.org の fmlsrc 以下が &fmldevel; ブランチです。
+</para>
+
+<para>
+cvs.fml.org にアクセスできる権限のある人は
+<screen>
+cvs -d cvs.fml.org:/cvsroot co fmlsrc
+</screen>
+でアクセスできます(注: cvs over ssh のみがサポートされます)。
+</para>
+
+</sect1>
+
+
+<!-- ====================================================  -->
+<sect1 id="cvsweb">
+	<title>
+	cvsweb による cvs へのアクセス
+	</title>
+
+<para>
+<ulink url="http://www.fml.org/cvsweb/fmlsrc/">
+http://www.fml.org/cvsweb/fmlsrc/
+</ulink>
+で cvs を見ることができます。
+</para>
+
+<warning>
+<para>
+特定のファイルの特定のバージョンだけをダウンロードするならこの方法が便
+利です。逆に、まとめてアーカイブ全体をダウンロードしたいような場合には
+使わないで下さい。
+</para>
+</warning>
+
+</sect1>
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
index 7654a304..e87156d4 100644
--- a/fml/doc/ja/tutorial/install/fml_on_unix.sgml
+++ b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapter.sgml,v 1.11 2002/04/01 23:41:02 fukachan Exp $
+	$FML: fml_on_unix.sgml,v 1.1 2002/07/02 10:39:34 fukachan Exp $
 -->
 
 <chapter id="install.fml.unix">
@@ -8,10 +8,29 @@
 	</title>
 
 
+<sect1 id="install.fml.unix.prepare">
+	<title>
+	インストールの準備
+	</title>
+
+
+<para>
+configure を実行する(後述)前に、
+適宜、ユーザ fml とグループ fml を作ってください。
+<screen>
+% su root
+# groupadd fml
+# useradd -g fml -m fml
+</screen>
+</para>
+
+</sect1>
+
+
 <!-- ====================================================== -->
 <sect1 id="install.fml.unix.configure">
 	<title>
-	概要
+	fml のインストール: configure
 	</title>
 
 
@@ -52,6 +71,9 @@ oldincludedir   /usr/include
 infodir         ${prefix}/info
 mandir          ${prefix}/man
 </screen>
+</para>
+
+<para>
 また
 <screen>
 fmlconfdir      $sysconfidr/fml             /usr/local/etc/fml        
@@ -78,8 +100,29 @@ configure --help
 </para>
 
 
+<sect2>
+	<title>
+	例: configure の実行
+	</title>
+
+<para>
+例: NetBSD は /usr/pkg 以下だね 
+<screen>
+% ./configure --prefix=/usr/pkg
+</screen>
+</para>
+
+
+<para>
+例: FreeBSD は全部 /usr/local 以下でいい？
+<screen>
+% ./configure
+</screen>
+</para>
+
 <para>
-サンプル
+例:	main.cf の置き場所として
+	/etc/fml を使うなら、こうする(Debian だとこうするべし？)。
 <screen>
 # ./configure --with-fmlconfdir=/etc/fml
 loading cache ./config.cache
@@ -156,6 +199,8 @@ Now you must run "make install".
 </screen>
 </para>
 
+</sect2>
+
 </sect1>
 
 
@@ -227,10 +272,15 @@ Now you must run "make install".
 		/var/spool/ml
 	  </entry>
           <entry>
-		ＭＬのホームディレクトリ。fml 4 と同じ目的です。
+		ＭＬのホームディレクトリ(の prefix)。
+		fml 4 と同じ目的に使われます。
 
 		注意: /var/spool/ml のオーナは INSTALL.sh の
 		owner 変数(デフォルトはユーザ fml)に設定されます。
+
+		なお、ドメインごとに別の prefix を用意して下さい。
+		たとえば fml.org 用は /var/spool/ml で、
+		nuinui.net 用には /var/spool/nuinui.net などのように。
 	  </entry>
         </row>
       </tbody>
@@ -241,14 +291,136 @@ Now you must run "make install".
 </sect1>
 
 
-<!--
-    ======================================================
-	main.cf の例
-    ======================================================
--->
+<!-- ====================================================== -->
+<sect1 id="install.fml.unix.makeinstall">
+	<title>
+	fml のインストール: make install
+	</title>
+
+<para>
+configure を実行後、ユーザ root になり、make install を実行して下さい。 
+<screen>
+% su root
+# make install
+</screen>
+</para>
+
+<warning>
+<para>
+configure はユーザ root で実行する必要はありませんが、
+make install はユーザ root で実行して下さい。
+間違えないように、configure も root で実行しても構いません。 
+</para>
+</warning>
+
+</sect1>
+
+
+<sect1 id="install.fml.unix.edit.main.cf">
+	<title>
+	main.cf を編集する
+	</title>
+
+<para>
+必要なら /usr/local/etc/fml/main.cf を編集して下さい。
+configure があなたの環境に合わせて main.cf を書換えしているはずなので
+configure のオプション指定が正しければ、
+編集の必要はまずないです。 
+</para>
+
+<!-- main.cf の見本 -->
 &sect.main.cf;
 
+</sect1>
+
+
+<sect1 id="install.fml.unix.edit.site.default.config.cf">
+	<title>
+	site_default_config.cf を編集する
+	</title>
+
+<para>
+そのホスト共通の設定ファイルがあります。
+/usr/local/etc/fml/site_default_config.cf 
+<footnote>
+<para>
+これは &fml4; の site_init.ph に相当するものです。
+</para>
+</footnote>
+です。
+必要に応じて編集してください。
+</para>
+
+<para>
+もちろん、この設定より各ＭＬの設定(例: /var/spool/ml/elena/config.cf)
+が優先されます。
+</para>
+
+<para>
+デフォルトでは見本として:)
+subject のタグをつけない設定だけが入っています。
+<screen>
+# $FML: site_default_config.cf.in,v 1.2 2002/04/01 10:16:48 fukachan Exp $
+#
+#               site default_config.cf EXAMPLE
+#
+# fml-devel loads .cf files in this order for elena ML.
+#      1. /etc/fml/defaults/$VERSION/default_config.cf
+#      2. /etc/fml/site_default_config.cf
+#      3. /etc/fml/domains/$DOMAIN/default_config.cf
+#      4. /var/spool/ml/elena/config.cf
+#
+# This file overrides the default "default_config.cf" configurations
+# in the following way.
+#
+
+# We want to disable the subject tag in articles by default.
+article_header_rewrite_rules	-=	rewrite_article_subject_tag
+
+
+
+#
+# site specific options.
+#
+</screen>
+</para>
+
+</sect1>
+
+
+<sect1 id="install.fml.unix.edit.virtual">
+	<title>
+	バーチャルドメインの場合
+	</title>
+
+<para>
+/usr/local/etc/fml/main.cf の編集は必要ありませんが、
+/usr/local/etc/fml/virtual は編集して下さい。
+site_default_config.cf はドメインに関わらず適用されることに注意してく
+ださい。
+</para>
+
+<para>
+fml.org がデフォルトのドメインとすると、fml.org のＭＬ群は 
+/var/spool/ml 以下をデフォルトでは使います。そのため、別のドメイン 
+nuinui.net のＭＬ群は別のディレクトリ(例: /var/spool/nuinui.net)を使う
+必要があります。
+</para>
+
+<para>
+その「ドメイン→ディレクトリ」の対応関係を 
+/usr/local/etc/fml/virtual に定義して下さい。
+<screen>
+nuinui.net	/var/spool/nuinui.net
+</screen>
+</para>
+
+</sect1>
+
+
+<!-- メールサーバの設定 -->
+&sect.install.postfix;
+&sect.install.qmail;
 
-<!-- ====================================================== -->
 
 </chapter>
diff --git a/fml/doc/ja/tutorial/install/postfix.sgml b/fml/doc/ja/tutorial/install/postfix.sgml
new file mode 100644
index 00000000..a8082824
--- /dev/null
+++ b/fml/doc/ja/tutorial/install/postfix.sgml
@@ -0,0 +1,52 @@
+<!--
+   $FML$
+-->
+
+<sect1 id="install.postfix">
+	<title>
+	メールサーバの設定 (postfix)
+	</title>
+
+<para>
+makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
+め postfix の設定を変更しておいて下さい。
+</para>
+
+
+<sect2>
+	<title>
+	デフォルトのドメイン(例: fml.org)
+	</title>
+
+
+<para>
+具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。
+<screen>
+alias_maps	=	hash:/etc/mail/aliases
+			hash:/var/spool/ml/etc/mail/aliases
+</screen>
+</para>
+
+</sect2>
+
+
+<sect2>
+	<title>
+	バーチャルドメイン(例: nuinui.net)
+	</title>
+
+
+<para>
+/usr/local/etc/fml/virtual の設定と合わせて下さい。
+<screen>
+alias_maps	=	hash:/etc/mail/aliases
+			hash:/var/spool/ml/etc/mail/aliases
+			hash:/var/spool/nuinui.net/etc/mail/aliases
+</screen>
+</para>
+
+
+</sect2>
+
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/install/qmail.sgml b/fml/doc/ja/tutorial/install/qmail.sgml
new file mode 100644
index 00000000..e8797b68
--- /dev/null
+++ b/fml/doc/ja/tutorial/install/qmail.sgml
@@ -0,0 +1,61 @@
+<!--
+   $FML$
+-->
+
+<sect1 id="install.qmail">
+	<title>
+	メールサーバの設定 (qmail)
+	</title>
+
+<para>
+makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
+め qmail の設定を変更しておいて下さい。
+</para>
+
+
+<sect2>
+	<title>
+	デフォルトのドメイン(例: fml.org)
+	</title>
+
+<para>
+<screen>
+/var/qmail/control/virtualdomains
+</screen>
+に、あらかじめ次のような設定を仕込んでおけば、
+makefml newml を実行するだけで 
+qmail でも自動的にＭＬが有効になります。
+<screen>
+fml.org:fml-fml.org
+</screen>
+</para>
+
+<para>
+この設定がうまく機能するかいなか？は
+makefml newml が作るファイル名に依存しています。
+詳細については
+<link linkend="setup.qmail.aliases">
+makefml newml の qmail に関する節
+</link>
+を参照してください。
+</para>
+
+</sect2>
+
+
+<sect2>
+	<title>
+	バーチャルドメイン(例: nuinui.net)
+	</title>
+
+<para>
+/usr/local/etc/fml/virtual の設定と合わせて下さい。
+<screen>
+nuinui.net:fml-nuinui.net
+</screen>
+</para>
+
+</sect2>
+
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/internals/main.cf.sgml b/fml/doc/ja/tutorial/internals/main.cf.sgml
index 557368c2..65915245 100644
--- a/fml/doc/ja/tutorial/internals/main.cf.sgml
+++ b/fml/doc/ja/tutorial/internals/main.cf.sgml
@@ -1,9 +1,10 @@
 <!--
-	$FML: main.cf.sgml,v 1.3 2002/04/01 23:41:03 fukachan Exp $
+   $FML: main.cf.sgml,v 1.4 2002/07/02 10:39:35 fukachan Exp $
 -->
-<sect1 id="main.cf">
+
+<sect2 id="main.cf">
 	<title>
-	/etc/fml/main.cf
+	例: /etc/fml/main.cf
 	</title>
 
 <para>
@@ -28,7 +29,7 @@ main.cf 
 
 <screen>
 #
-# $FML: main.cf.in,v 1.12 2002/04/01 23:41:09 fukachan Exp $
+# $FML: main.cf.sgml,v 1.4 2002/07/02 10:39:35 fukachan Exp $
 #
 
 # fml version
@@ -114,4 +115,5 @@ virtual_maps		=	$config_dir/virtual
 
 </screen>
 </para>
-</sect1>
+
+</sect2>
diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml
index ba562d77..2e9726e7 100644
--- a/fml/doc/ja/tutorial/overview/fml.sgml
+++ b/fml/doc/ja/tutorial/overview/fml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.10 2002/04/01 23:41:06 fukachan Exp $
+   $FML: fml.sgml,v 1.1 2002/07/02 10:39:37 fukachan Exp $
 -->
 
 <chapter id="overview">
@@ -7,20 +7,6 @@
 	&fmldevel; の概要
 	</title>
 
-<important>
-
-<para>
-&fmldevel; は &fml4; 相当のものを完全に一から書き直すプロジェクトです。
-使い方の見かけは &fml4; に"似せて"います。
-主な注意点は
-root での作業、
-configure の使用、
-そして /usr/local/etc/fml/ 以下のファイル、
-特に /usr/local/etc/fml/main.cf というグローバルな設定ファイルの編集です。
-</para>
-
-</important>
-
 
 <!-- ======================================================== -->
 <sect1>
@@ -40,70 +26,76 @@ configure 
 
     <listitem>
 	<para>
-	postfix スタイルの設定ファイル
+	設定ファイル形式が新しくなりました。
+	postfix スタイルの設定ファイルです。
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	配送、
-	ヘッダの書き換え、
-	フィルタ( 4.0 の Envelope Filter に相当するもの )
+	makefml によるＭＬの作成/削除、メンバーの登録/削除など
 	</para>
     </listitem>
 
     <listitem>
 	<para>
-	MTA が起動するメインのプログラム:
-	fml.pl distribute command
+	CGI によるＭＬの作成/削除、メンバーの登録/削除など
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	いくつかのユーティリティ:
-	fmlconf
-	fmldoc
-	fmlhtmlify
-	fmlsch
-	fmlthread
-	fmlspool
-	makefml
+	配送、
+	ヘッダの書き換え、
+	フィルタ( 4.0 の Envelope Filter と Content Filter に相当するもの )、
+	エラーメール解析
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	CGI :
-	fmlsch.cgi
-	fmlthread.cgi
-	makefml.cgi
+	IPv6 による配送
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	IPv6 による配送
+	スレッド追跡システム(CUI と CGI を含む):
+	(fmlthread fmlthread.cgi)
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	スレッド追跡システム(CUI と CGI を含む):
-	(fmlthread fmlthread.cgi)
+	記事の HTML 化システム:
+	fmlhtmlify および makefml に HTML 化コマンドがあります。
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	記事の HTML 化システム:
-	fmlhtmlify および makefml に HTML 化コマンドがあります。
+	MTA が起動するメインのプログラム:
+	fml.pl distribute command
+	</para>
+    </listitem>
+
+
+    <listitem>
+	<para>
+	いくつかのユーティリティ:
+	fmlconf
+	fmldoc
+	fmlhtmlify
+	fmlsch
+	fmlthread
+	fmlspool
+	makefml
 	</para>
     </listitem>
 
@@ -129,17 +121,22 @@ configure 
 	インストール作業の概略
 	</title>
 
+
+<important>
+
 <para>
-以下で、特に触れていない概念(例: ＭＬとは？)については &fml4; と同様です。
-くわしくは &fml4; の資料(
-	<ulink url="http://www.fml.org/fml/">
-	http://www.fml.org/fml/
-	</ulink>
-	や
-	&fmlbible;
-)を適宜、参照して下さい。
+&fmldevel; は &fml4; 相当のものを完全に一から書き直すプロジェクトです。
+使い方の見かけは &fml4; に"似せて"います。
+インストールにおける主な注意点は
+root での作業、
+configure の使用、
+そして /usr/local/etc/fml/ 以下のファイル、
+特に /usr/local/etc/fml/main.cf というグローバルな設定ファイルの編集です。
 </para>
 
+</important>
+
+
 <para>
 さて、いつものように elena ＭＬの作成過程を例にとりましょう。
 インストールのおおまかな流れは次のようになります。
@@ -158,12 +155,14 @@ configure 
    <listitem>
 	<para>
 	<link linkend="install.fml.unix">
-	ユーザ root でインストールをする。
-	まず、ユーザ fml とグループ fml を作成し、
+	ユーザ root でインストールをします。
+	ユーザ root になり、
+	まず、ユーザ fml とグループ fml を作成します。
+	その後、
 	<link linkend="install.fml.unix.configure">
 	configure
 	</link>
-	および make を実行して下さい。
+	および make install を実行して下さい。
 	</link>
 <screen>
 % su root
@@ -260,15 +259,15 @@ elena@fml.org 
 </screen>
 とします。
 詳しくは
-<link linkend="usage.newml">
-<xref linkend="usage.newml">
+<link linkend="setup.newml">
+<xref linkend="setup.newml">
 </link>
 を参照してください。
 </para>
 
 <para>
 一方、バーチャルドメイン(nuinui.net)の場合は、
-アドレスを全部指定して下さい。
+ＭＬのアドレスを全部指定して下さい。
 elena@nuinui.net を作る場合は、次のように実行して下さい。
 <screen>
 % su fml
@@ -292,7 +291,7 @@ elena@nuinui.net 
 </screen>
 で構いません。
 一方、バーチャルドメイン(nuinui.net)の場合は、
-アドレスを全部指定して下さい。
+ＭＬのアドレスを全部指定して下さい。
 <screen>
 % su fml
 % makefml subscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp
@@ -339,11 +338,40 @@ elena@nuinui.net 
 </warning>
 
 
+<sect2>
+	<title>
+	そのホスト共通の設定
+	</title>
+
+<para>
+/usr/local/etc/fml/site_default_config.cf
+はこのホストで動く fml すべてに影響を与えます。
+<footnote>
 <para>
-elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集
-して下さい。
-フォーマットは postfix の設定ファイルと同様というとわかりやすいでしょう。
-(&fml4; の config.ph よりは cf にやや近いですが)
+これは &fml4; の site_init.ph に相当するものです。
+</para>
+</footnote>
+</para>
+
+<para>
+フォーマットは、config.cf (後述)と同様で、
+指定できる変数も config.cf と同じです。
+</para>
+
+</sect2>
+
+
+<sect2>
+	<title>
+	elena ＭＬの設定
+	</title>
+
+<para>
+elena ＭＬの設定のカスタマイズは 
+/var/spool/ml/elena/config.cf
+を編集して下さい。
+フォーマットは postfix の設定ファイルと同様です(&fml4; の config.ph よ
+りは cf にやや近いですが)。わかりやすいでしょ？:-)
 </para>
 
 <para>
@@ -365,6 +393,8 @@ elena 
 これは &fmldevel; の特徴です。
 </para>
 
+</sect2>
+
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/overview/ml.sgml b/fml/doc/ja/tutorial/overview/ml.sgml
index cdaf0685..e9299651 100644
--- a/fml/doc/ja/tutorial/overview/ml.sgml
+++ b/fml/doc/ja/tutorial/overview/ml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.10 2002/04/01 23:41:06 fukachan Exp $
+   $FML: ml.sgml,v 1.1 2002/07/02 10:39:37 fukachan Exp $
 -->
 
 <chapter id="overview.ml">
@@ -19,15 +19,15 @@
 <para>
 見栄えはメールソフトによって変わりますが、メールサーバがやりとりしてい
 るのは次のような形式のテキストのファイルに過ぎません。
-<screen>
-From: rudo@nuinui.net
-To: kenken@nuinui.net
-Subject: あそぼうよ
+	<screen>
+	From: rudo@nuinui.net
+	To: kenken@nuinui.net
+	Subject: あそぼうよ
 
-やは、けんけん。ぼく、るどだよ。
+	やは、けんけん。ぼく、るどだよ。
 
-// るど
-</screen>
+	// るど
+	</screen>
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/setup/cgi.admin.sgml b/fml/doc/ja/tutorial/setup/cgi.admin.sgml
new file mode 100644
index 00000000..5385a40c
--- /dev/null
+++ b/fml/doc/ja/tutorial/setup/cgi.admin.sgml
@@ -0,0 +1,147 @@
+<!--
+   $FML$
+-->
+
+<chapter id="setup.cgi">
+	<title>
+	ドメインマスタ CGI の設定
+	</title>
+
+
+<para>
+参照: CGI の内部構造については
+<link linkend="internal.cgi.method">
+<xref linkend="internal.cgi.method">
+</link>
+を参照して下さい。
+</para>
+
+<warning>
+<para>
+apache で suexec を使うことを前提としています。
+</para>
+</warning>
+
+
+<sect1 id="setup.cgi.overview">
+	<title>
+	CGI 
+	</title>
+
+<para>
+makefml newml を実行すると
+CGI による設定ツールがデフォルトで用意されています。
+この CGI は二種類あり、
+ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方あります。
+</para>
+
+<warning>
+<para>
+現在はドメイン全体を管理する CGI しかありません。
+</para>
+</warning>
+
+<para>
+例えば、elena@fml.org ＭＬを作成すると
+fml.org の全ＭＬを管理する CGI
+<screen>
+http://lists.fml.org/~fml/cgi-bin/fml/fml.org/admin/config.cgi
+</screen>
+と elena ML だけを管理する CGI
+<screen>
+http://lists.fml.org/~fml/cgi-bin/fml/fml.org/ml-admin/elena/config.cgi
+</screen>
+の両方が makefml により用意されます。
+</para>
+
+</sect1>
+
+
+<sect1 id="setup.cgi.admin.cgi.overview">
+	<title>
+	例: ドメインマスタ CGI の画面
+	</title>
+
+<para>
+この CGI は
+「makefml を実行できる権限を与えても良いけれど、
+でも、UNIX のコマンドラインを使うのがちょっと辛い」
+という人を想定しています。
+よって、ＭＬの作成などができるわけですが、
+makefml のすべての機能が使えるわけでもありません。 
+</para>
+
+<para>
+画面を見るとわかる通り、
+CGI で可能な項目は makefml のサブセットとなっています。
+<screen>
+例: CGI トップ画面
+
+                     @home.fml.org CGI for configuration
+
+fml admin menu             fml CGI interface for @home.fml.org ML's
+mailing list:
+[elena]              左のナビゲーションバーから、ＭＬ(mailing list)とコマ
+command:             ンド(command)を選択し、 submit ボタンを押して下さい
+[subscribe  ]        。
+[submit][reset]
+                     subscribe   アドレスの追加
+                     unsubscribe アドレスの削除
+                     addadmin    リモート管理者アドレスの追加
+                     byeadmin    リモート管理者アドレスの削除
+options Language:    list        アドレスリストを見る
+[Japanese] [change]  log         ログを見る
+                     newml       ＭＬの作成
+                     rmml        ＭＬの削除
+</screen>
+</para>
+
+
+<para>
+なお、画面の左下もしくは右にヘルプメッセージが表示されるので
+それを参考にして下さい。
+もちろんコマンドごとに異なります:)
+</para>
+
+</sect1>
+
+
+<sect1 id="setup.cgi.admin.cgi.newml">
+	<title>
+	CGI の使い方の例: ＭＬの作成
+	</title>
+
+<para>
+左の画面のコマンドで newml を選択肢、
+submit ボタンを押して下さい。
+ML 名を選択する必要はありません:)
+</para>
+
+<para>
+中央に、ＭＬ名の入力を促す画面が現れるので、
+作成するＭＬ名を入力し、中央の submit ボタンを押して下さい。
+</para>
+
+</sect1>
+
+
+<sect1 id="setup.cgi.admin.cgi.newml">
+	<title>
+	CGI の使い方の例: メンバー登録
+	</title>
+
+<para>
+左の画面のコマンドで ML 名と subscribe を選択肢、
+submit ボタンを押して下さい。
+</para>
+
+<para>
+中央に、アドレスの入力を促す画面が現れるので、
+登録したいアドレスを入力し、
+中央の submit ボタンを押して下さい。
+</para>
+
+</sect1>
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml
new file mode 100644
index 00000000..e69de29b
diff --git a/fml/doc/ja/tutorial/usage/cgi.sgml b/fml/doc/ja/tutorial/usage/cgi.sgml
deleted file mode 100644
index bc1fb346..00000000
--- a/fml/doc/ja/tutorial/usage/cgi.sgml
+++ /dev/null
@@ -1,44 +0,0 @@
-<!--
-   $FML: cgi.sgml,v 1.3 2002/04/01 23:41:07 fukachan Exp $
--->
-
-<chapter id="cgi">
-	<title>
-	設定ツール: CGI
-	</title>
-
-<para>
-CGI による設定ツールです。
-CGI で可能な項目は makefml のサブセットとなります。
-<screen>
-例: CGI トップ画面
-
-                     @home.fml.org CGI for configuration
-
-fml admin menu             fml CGI interface for @home.fml.org ML's
-mailing list:
-[elena]              左のナビゲーションバーから、ＭＬ(mailing list)とコマ
-command:             ンド(command)を選択し、 submit ボタンを押して下さい
-[subscribe  ]        。
-[submit][reset]
-                     subscribe   アドレスの追加
-                     unsubscribe アドレスの削除
-                     addadmin    リモート管理者アドレスの追加
-                     byeadmin    リモート管理者アドレスの削除
-options Language:    list        アドレスリストを見る
-[Japanese] [change]  log         ログを見る
-                     newml       ＭＬの作成
-                     rmml        ＭＬの削除
-</screen>
-</para>
-
-<para>
-なお CGI プロセスのメソッドについては
-<link linkend="internal.cgi.method">
-<xref linkend="internal.cgi.method">
-</link>
-を参照して下さい。
-</para>
-
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/usage/newml.sgml b/fml/doc/ja/tutorial/usage/newml.sgml
deleted file mode 100644
index d6ac1c09..00000000
--- a/fml/doc/ja/tutorial/usage/newml.sgml
+++ /dev/null
@@ -1,264 +0,0 @@
-<!--
-   $FML: newml.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $
--->
-
-<!--
-
-        案１
-        /etc/fml/ドメイン名/aliases
-
-        案２ (prefix は virtual_maps でドメインごとに定義されているの
-                で一意に定まる)
-        /var/spool/ml/etc/mail/aliases
-
--->
-
-
-<chapter id="usage.newml">
-	<title>
-	UNIX 上でＭＬを作成する
-	</title>
-
-
-<sect1>
-	<title>
-	makefml newml (デフォルトのドメイン)
-	</title>
-
-<para>
-makefml を使ってＭＬを作成します。
-使い方は &fml4; と同様です。
-<screen>
-% su fml
-% makefml newml elena
-</screen>
-</para>
-
-
-<para>
-この時、makefml newml は以下のような処理をします。
-
-<itemizedlist>
-
-   <listitem>
-        <para>
-	/var/spool/ml/elena へ
-	<screen>
-	config.cf
-	include
-	include-ctl
-	</screen>
-	を作る(適宜、elena やドメインの値を変換しながら)
-        </para>
-   </listitem>
-
-   <listitem>
-        <para>
-	/var/spool/ml/etc/mail/aliases に elena の設定を仕込む
-        </para>
-   </listitem>
-
-   <listitem>
-        <para>
-	<screen>
-	~fml/public_html/$domain/$ml/
-	</screen>
-	例えば elena@fml.org なら
-	<screen>
-	~fml/public_html/fml.org/elena/
-	</screen>
-	を用意する。ここに HTML 化された記事が自動的に作られることになる
-        </para>
-   </listitem>
-
-   <listitem>
-        <para>
-	CGI インターフェイスを用意する。
-	ドメインで一番偉いインターフェイス(そのドメインのＭＬは全部操
-	作できる)が
-	<screen>
-	~fml/public_html/cgi-bin/fml/$domain/admin/menu.cgi
-	</screen>
-	また、各ＭＬで一番偉いインターフェイス(そのＭＬの操作ができる)
-	<screen>
-	~fml/public_html/cgi-bin/fml/$domain/ml-admin/menu.cgi
-	</screen>
-        </para>
-   </listitem>
-
-</itemizedlist>
-</para>
-
-</sect1>
-
-
-<sect1>
-	<title>
-	設定ファイル config.cf のカスタマイズ
-	</title>
-
-<para>
-makefml は
-config.cf (設定ファイル) と
-fml を起動するために MTA が呼び出すファイルである
-include
-および
-include-ctl をインストールしてくれます。
-<screen>
-% su fml
-% makefml newml elena
-   ... snip ...
-% ls /var/spool/ml/elena
-config.cf include include-ctl
-</screen>
-</para>
-
-<para>
-ＭＬのカスタマイズは config.cf をエディタで編集して下さい。
-<warning>
-<para>
-まだ、設定ツールはできていません。
-</para>
-</warning>
-とりあえず config.cf の先頭の ml_domain と ml_name が
-正しいかどうかを確認して下さい。
-<screen>
-config.cf の例
-
-# ドメイン名 (参照: 以下のアドレスを見よ $ml_domain がこの値に展開される)
-ml_domain           = fml.org
-
-# ML の名前
-ml_name		    = elena
-
-# 管理者のアドレス
-maintainer	    = $ml_name-admin@$ml_domain
-
-# 投稿用のアドレス
-address_for_post    = $ml_name@$ml_domain
-
-# コマンド用のアドレス
-address_for_command = $ml_name-ctl@$ml_domain
-</screen>
-</para>
-
-<para>
-include include-ctl aliases の書き方は &fml4; と同様です。
-include ファイルの PATH がちょっと違いますが、
-aliases の設定の仕方は一緒です。
-</para>
-
-<para>
-/var/spool/ml/elena/include ファイルは
-<screen>
-"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena"
-</screen>
-
-/var/spool/ml/elena/include-ctl ファイルは
-<screen>
-"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr"
-</screen>
-</para>
-
-</sect1>
-
-
-<sect1>
-	<title>
-	aliaess の更新
-	</title>
-
-<para>
-makefml はシステムの aliases を変更することはありませんが、
-$ml_home_prefix/etc/mail/aliases
-への追加と aliases.db の更新が自動的に行なわれているはずです。
-</para>
-
-
-<sect2>
-	<title>
-	postfix の設定
-	</title>
-
-<para>
-makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
-め postfix の設定を変更しておいて下さい。
-具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。
-<screen>
-alias_maps	=	hash:/etc/mail/aliases
-			hash:/var/spool/ml/etc/mail/aliases
-</screen>
-</para>
-
-</sect2>
-
-
-<sect2>
-	<title>
-	qmail の設定
-	</title>
-
-<para>
-makefml newml は次のような qmail 用の設定ファイルを作ります。
-<screen>
-~/.qmail-fml:org-elena
-~/.qmail-fml:org-elena-ctl
-</screen>
-よって
-<screen>
-/var/qmail/control/virtualdomains
-</screen>
-に、あらかじめ次のような設定を仕込んでおけば、
-makefml newml を実行するだけで 
-qmail でも自動的にＭＬが有効になります。
-<screen>
-fml.org:fml-fml.org
-</screen>
-</para>
-
-<warning>
-<para>
-この設定は、ＭＬ用に一つのドメインをまるまる使うことを前提としています。
-</para>
-</warning>
-
-</sect2>
-
-
-<sect2>
-	<title>
-	例: /var/spool/ml/etc/mail/aliases
-	</title>
-
-<para>
-aliases のエントリは
-$ml_home_prefix/etc/mail/aliases
-に追加されます。
-<screen>
-### BEGIN-elena@fml.org-ML-aliases ###
-
-# address for post
-elena: :include:/var/spool/ml/elena/include
-owner-elena: fukachan
-
-# address for command
-elena-ctl: :include:/var/spool/ml/elena/include-ctl
-owner-elena-ctl: fukachan
-
-# maintainer
-elena-request: elena-admin
-elena-admin: fukachan
-
-### END-elena@fml.org-ML-aliases ###
-</screen>
-バーチャルドメインの場合、
-$ml_home_prefix の部分は
-$virtual_maps にしたがって自動的に変化します。
-</para>
-
-</sect2>
-
-</sect1>
-
-
-</chapter>
-- 
cgit v1.2.1