sync the first 8 chapters w/ reality, relocate a few, clean up

4 files changed, 384 insertions, 10 deletions

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>