clean up. update/fix descriptions.

38 files changed, 1083 insertions, 597 deletions

diff --git a/fml/doc/ja/tutorial/command/module.sgml b/fml/doc/ja/tutorial/command/module.sgml
index a3de06ac..c3fedddd 100644
--- a/fml/doc/ja/tutorial/command/module.sgml
+++ b/fml/doc/ja/tutorial/command/module.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: module.sgml,v 1.6 2008/08/17 18:28:36 fukachan Exp $
+   $FML: module.sgml,v 1.7 2009/12/26 13:33:25 fukachan Exp $
 -->
 
 
@@ -22,7 +22,7 @@ FML::Command		FML::Command クラス以下への入口、dispatcher
 FML::Command::User	ユーザ用コマンド群
 FML::Command::Admin	管理者用コマンド群
 </screen>
-例えば、(コマンドメールでの)ユーザ用コマンドの場合
+たとえば、(コマンドメールでの)ユーザ用コマンドの場合
 FML::Command を経由して
 FML::Command::User::コマンド
 モジュールを呼び出しています。
diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml
index 692ab877..7d725803 100644
--- a/fml/doc/ja/tutorial/delivery/chapter.sgml
+++ b/fml/doc/ja/tutorial/delivery/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.17 2008/08/18 13:21:42 fukachan Exp $
+   $FML: chapter.sgml,v 1.18 2009/12/26 13:33:25 fukachan Exp $
 -->
 
 
@@ -38,7 +38,7 @@ SMTP、ESMTP
 </para>
 
 <para>
-例えば次のように使います。
+たとえば次のように使います。
 <screen>
     use Mail::Delivery::SMTP;
     my $service = new Mail::Delivery::SMTP;
diff --git a/fml/doc/ja/tutorial/devel/create_program.sgml b/fml/doc/ja/tutorial/devel/create_program.sgml
index d7c2a589..5d82c67e 100644
--- a/fml/doc/ja/tutorial/devel/create_program.sgml
+++ b/fml/doc/ja/tutorial/devel/create_program.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: create_program.sgml,v 1.11 2008/08/18 13:21:42 fukachan Exp $
+   $FML: create_program.sgml,v 1.12 2009/12/26 13:33:25 fukachan Exp $
 -->
 
 
@@ -75,8 +75,8 @@ Unix 伝統のスペース区切りなので、すぐ分かります。
 
 <para>
 最後に、呼びたい名前のファイルを loader と link もしくは symlink する
-ことで実行が可能になります。例えば、標準のインストールでは、次のように
-なっています。
+ことで実行が可能になります。
+たとえば、標準のインストールでは、次のようになっています。
 <screen>
 % ls -l /usr/local/libexec/fml
 lrwxr-xr-x  1 root  wheel     6 Apr 14 18:25 command@ -> loader
diff --git a/fml/doc/ja/tutorial/devel/docbook.sgml b/fml/doc/ja/tutorial/devel/docbook.sgml
index b9beef96..e08d25c8 100644
--- a/fml/doc/ja/tutorial/devel/docbook.sgml
+++ b/fml/doc/ja/tutorial/devel/docbook.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: docbook.sgml,v 1.8 2008/08/17 12:36:19 fukachan Exp $
+   $FML: docbook.sgml,v 1.9 2009/12/26 13:33:25 fukachan Exp $
 -->
 
 
@@ -56,7 +56,7 @@ HTML のもっと厳密なものだと思って下さい。
 </para>
 
 <para>
-例えば、”本”という概念を考えてみます。
+たとえば、”本”という概念を考えてみます。
 まず”本”には章、節といった構成単位があります。
 節の中にはパラグラフがありますし、文には脚注がついたり、
 図などが挟み込まれたりします。
@@ -64,7 +64,7 @@ HTML のもっと厳密なものだと思って下さい。
 
 <para>
 これらの概念には、ある関係があります。
-例えば”章”は”節”を含みますが、”節”は”章”を含みません。
+たとえば”章”は”節”を含みますが、”節”は”章”を含みません。
 そして、文は必ず「あるパラグラフ」の中に「ある」ものです。
 </para>
 
diff --git a/fml/doc/ja/tutorial/devel/inet6.sgml b/fml/doc/ja/tutorial/devel/inet6.sgml
index b2feb69a..ea474580 100644
--- a/fml/doc/ja/tutorial/devel/inet6.sgml
+++ b/fml/doc/ja/tutorial/devel/inet6.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: inet6.sgml,v 1.4 2002/04/01 23:41:02 fukachan Exp $
+	$FML: inet6.sgml,v 1.5 2004/10/06 09:07:36 fukachan Exp $
 -->
 
 <appendix id="inet6">
@@ -21,7 +21,7 @@ NetBSD の IPv6 の解説
 
 <para>
 まず、上流 ISP から IPv6 アドレス空間を割り当ててもらいます。
-例えば 2001:240:22::/48 などといったアドレスがもらえます。
+たとえば 2001:240:22::/48 などといったアドレスがもらえます。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/install/download.sgml b/fml/doc/ja/tutorial/install/download.sgml
index b70b576c..032b9f45 100644
--- a/fml/doc/ja/tutorial/install/download.sgml
+++ b/fml/doc/ja/tutorial/install/download.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: download.sgml,v 1.5 2008/08/07 01:03:16 fukachan Exp $
+   $FML: download.sgml,v 1.6 2008/08/18 13:21:42 fukachan Exp $
 -->
 
 
@@ -30,7 +30,7 @@
 fml-VERSION-DATA.tar.gz
 </screen>
 形です。
-VERSION は 8.0 正式リリース以前なのでなので 8.0 より少し小さい値
+VERSION は 8.0 正式リリース前なので 8.0 より少し小さい値
 7.98.x などとなっています。
 ファイル名に日付が入っていますので、
 日付の新しいものを選んでダウンロードして下さい。
diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
index b53527dd..dc4572fc 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: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
+   $FML: fml_on_unix.sgml,v 1.13 2008/08/18 13:21:42 fukachan Exp $
 -->
 
 
@@ -17,7 +17,7 @@
 
 <para>
 configure を実行する(後述)前に、
-適宜、ユーザ fml とグループ fml を作ってください。
+ユーザ fml とグループ fml を作ってください。
 <screen>
 例
 
@@ -38,9 +38,9 @@ configure を実行する(後述)前に、
 
 
 <para>
-configure (GNU autoconf) および make を実行して下さい。
-configure の前に、適宜、ユーザ fml とグループ fml を作っておく必要があ
-りますので注意して下さい。
+configure (by GNU autoconf) および make を実行して下さい。
+configure の前に、
+ユーザ fml とグループ fml を作っておく必要がありますので注意して下さい。
 ここまでの作業をまとめて書くと、次のようになります。
 <screen>
 % su root
@@ -49,13 +49,13 @@ configure の前に、適宜、ユーザ fml とグループ fml を作っておく必要があ
 # ./configure
 # make install
 </screen>
-configure が適宜、script 群や .cf 群の変数を書き換えます。
+configure が適宜 script 群や .cf 群の変数を書き換えます。
 </para>
 
 <para>
-make install を実行すると、configure が生成した etc/fml/install.cf を
-元に、configure が生成した install.pl (perl script) がインストールを行
-ないます。
+make install を実行する際には、
+configure が生成した etc/fml/install.cf を元に、
+configure が生成した install.pl (perl script) がインストールを行ないます。
 </para>
 
 <para>
@@ -96,13 +96,56 @@ configure --help
 で表示されます。
 <screen>
 例
- 
+
+./configure --help
+
+`configure' configures this package to adapt to many kinds of systems.
+
+	... snip ...
+
+Installation directories:
+  --prefix=PREFIX         install architecture-independent files in PREFIX
+                          [/usr/local]
+  --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
+                          [PREFIX]
+
+	... snip ...
+
+Fine tuning of the installation directories:
+  --bindir=DIR            user executables [EPREFIX/bin]
+  --sbindir=DIR           system admin executables [EPREFIX/sbin]
+  --libexecdir=DIR        program executables [EPREFIX/libexec]
+  --sysconfdir=DIR        read-only single-machine data [PREFIX/etc]
+  --sharedstatedir=DIR    modifiable architecture-independent data [PREFIX/com]
+  --localstatedir=DIR     modifiable single-machine data [PREFIX/var]
+  --libdir=DIR            object code libraries [EPREFIX/lib]
+  --includedir=DIR        C header files [PREFIX/include]
+  --oldincludedir=DIR     C header files for non-gcc [/usr/include]
+  --datarootdir=DIR       read-only arch.-independent data root [PREFIX/share]
+  --datadir=DIR           read-only architecture-independent data [DATAROOTDIR]
+  --infodir=DIR           info documentation [DATAROOTDIR/info]
+  --localedir=DIR         locale-dependent data [DATAROOTDIR/locale]
+  --mandir=DIR            man documentation [DATAROOTDIR/man]
+  --docdir=DIR            documentation root [DATAROOTDIR/doc/PACKAGE]
+  --htmldir=DIR           html documentation [DOCDIR]
+  --dvidir=DIR            dvi documentation [DOCDIR]
+  --pdfdir=DIR            pdf documentation [DOCDIR]
+  --psdir=DIR             ps documentation [DOCDIR]
+
+Optional Packages:
+  --with-PACKAGE[=ARG]    use PACKAGE [ARG=yes]
+  --without-PACKAGE       do not use PACKAGE (same as --with-PACKAGE=no)
   --without-warning       run perl as perl without -w
   --with-fmlconfdir=DIR   use DIR instead of SYSCONFDIR/fml
   --with-mlspooldir=DIR   use DIR instead of /var/spool/ml
   --with-fml-owner=USER   use USER instead of fml
   --with-fml-group=GROUP  use GROUP instead of fml
-  --with-default-domain=DOMAIN  use DOMAIN as the ML domain
+  --with-default-domain=DOMAIN     use DOMAIN as the default ML domain
+  --with-default-hostname=HOSTNAME use HOSTNAME as the default hostname
+  --without-mime-component-filter  disable mime_component_filter
+  --with-group-writable-fmlconfdir=DIR   instead of \$fmlconfdir/config.gw
+  --with-ml-home-prefix-map=PATH   use PATH as primary_ml_home_prefix_map
+  --with-group-writable-ml-home-prefix-map
 </screen>
 
 </para>
@@ -132,78 +175,120 @@ configure --help
 例:	main.cf の置き場所として
 	/etc/fml を使うなら、こうする(Debian だとこうするべし？)。
 <screen>
-# ./configure --with-fmlconfdir=/etc/fml
-loading cache ./config.cache
-checking for perl... (cached) perl
-checking for perl... (cached) /usr/local/bin/perl
-checking whether optional useful commands are available or not
-checking for cksum... (cached) /usr/bin/cksum
-checking for md5... (cached) /usr/bin/md5
-checking for ls... (cached) /bin/ls
-checking for tar... (cached) /usr/bin/tar
-checking for gzip... (cached) /usr/bin/gzip
-checking for zcat... (cached) /usr/bin/zcat
-checking for gunzip... (cached) /usr/bin/gunzip
-checking for lha... (cached) /usr/pkg/bin/lha
+#  ./configure --with-fmlconfdir=/etc/fml
+checking for perl... perl
+checking for perl... /usr/bin/perl
+"checking whether optional useful commands are available or not"
+checking for cc... /usr/bin/cc
+checking for install... /usr/bin/install
+checking for cksum... /usr/bin/cksum
+checking for sum... /usr/bin/sum
+checking for md5... /usr/bin/md5
+checking for digest... /usr/bin/digest
+checking for ls... /bin/ls
+checking for tar... /bin/tar
+checking for gzip... /usr/bin/gzip
+checking for zcat... /usr/bin/zcat
+checking for gzcat... /usr/bin/gzcat
+checking for gunzip... /usr/bin/gunzip
+checking for lha... no
 checking for ish... no
-checking for bzip2... (cached) /usr/bin/bzip2
-checking for bunzip2... (cached) /usr/bin/bunzip2
-checking for uuencode... (cached) /usr/bin/uuencode
-checking for compress... (cached) /usr/bin/compress
-checking for sendmail... (cached) /usr/sbin/sendmail
-checking for newaliases... (cached) /usr/bin/newaliases
-checking for postfix... (cached) /usr/sbin/postfix
-checking for postalias... (cached) /usr/sbin/postalias
-checking for postconf... (cached) /usr/sbin/postconf
-checking for postmap... (cached) /usr/sbin/postmap
-checking for nkf... (cached) /usr/pkg/bin/nkf
+checking for bzip2... /usr/bin/bzip2
+checking for bunzip2... /usr/bin/bunzip2
+checking for uuencode... /usr/bin/uuencode
+checking for compress... /usr/bin/compress
+checking for sendmail... /usr/sbin/sendmail
+checking for makemap... no
+checking for newaliases... /usr/bin/newaliases
+checking for postfix... /usr/sbin/postfix
+checking for postalias... /usr/sbin/postalias
+checking for postconf... /usr/sbin/postconf
+checking for postmap... /usr/sbin/postmap
+checking for nkf... /usr/bin/nkf
 checking for kakasi... no
 checking for namazu... no
-checking for pgp... (cached) /usr/pkg/bin/pgp
-checking for pgp5... no
-checking for pgpe... no
-checking for pgpk... no
-checking for pgps... no
-checking for pgpv... no
-checking for gpg... no
-checking for less... (cached) /usr/bin/less
-checking for more... (cached) /usr/bin/more
-checking for w3m... (cached) /usr/pkg/bin/w3m
-updating cache ./config.cache
-creating ./config.status
-creating config.sh
-creating fml/etc/main.cf
-creating fml/etc/default_config.cf.ja
-creating fml/etc/site_default_config.cf
-creating fml/libexec/loader
-creating fml/bin/fmlalias
-creating fml/bin/fmlconf
-creating fml/bin/fmldoc
-creating fml/bin/fmlhtmlify
-creating fml/bin/fmlsch
-creating fml/bin/fmlthread
-creating fml/bin/fmlspool
-creating fml/bin/makefml
-enabled perl -w
-
-fml has been configure with the following options:
-
-                 prefix: /usr/local
-            exec_prefix: ${prefix}
-                 bindir: ${exec_prefix}/bin
-                sbindir: ${exec_prefix}/sbin
-                lib_dir: ${exec_prefix}/lib
-            libexec_dir: ${exec_prefix}/libexec
-                 mandir: ${prefix}/man
-                datadir: ${prefix}/share
-
-      fml process owner: fml
-      fml process group: fml
-             fmlconfdir: /etc/fml
-             mlspooldir: /var/spool/ml
-         default domain: home.fml.org
-
-Now you must run "make install".
+checking for pgp... /usr/bin/pgp
+checking for pgp5... /usr/bin/pgp5
+checking for pgpe... /usr/bin/pgpe
+checking for pgpk... /usr/bin/pgpk
+checking for pgps... /usr/bin/pgps
+checking for pgpv... /usr/bin/pgpv
+checking for gpg... /usr/bin/gpg
+checking for gpgv... /usr/bin/gpgv
+checking for gpgsplit... /usr/bin/gpgsplit
+checking for less... /usr/bin/less
+checking for more... /usr/bin/more
+checking for w3m... /usr/bin/w3m
+checking for spamassassin... no
+checking for spamd... no
+checking for spamc... no
+checking for bogofilter... no
+checking for clamscan... /usr/bin/clamscan
+checking for vi... /usr/bin/vi
+checking for ng... /usr/bin/ng
+checking for mule... /usr/bin/mule
+checking for emacs... no
+checking for xemacs... no
+configure: creating ./config.status
+config.status: creating install.pl
+config.status: creating config.sh
+config.status: creating fml/etc/install.cf
+config.status: creating fml/etc/main.cf
+config.status: creating fml/etc/default_config.cf.ja
+config.status: creating fml/etc/default_config.cf.en
+config.status: creating fml/etc/site_default_config.cf
+config.status: creating fml/libexec/loader
+config.status: creating fml/bin/fmladdr
+config.status: creating fml/bin/fmlalias
+config.status: creating fml/bin/fmlconf
+config.status: creating fml/bin/fmldoc
+config.status: creating fml/bin/fmlhtmlify
+config.status: creating fml/bin/fmlsch
+config.status: creating fml/bin/fmlproj
+config.status: creating fml/bin/fmlpgp
+config.status: creating fml/bin/fmlpgp5
+config.status: creating fml/bin/fmlpgpe
+config.status: creating fml/bin/fmlpgpk
+config.status: creating fml/bin/fmlpgps
+config.status: creating fml/bin/fmlpgpv
+config.status: creating fml/bin/fmlgpg
+config.status: creating fml/bin/fmlgpgv
+config.status: creating fml/bin/fml
+config.status: creating fml/bin/makefml
+enabled: perl -w
+
+fml has been configured with the following options:
+
+                    prefix: /usr/local
+               exec_prefix: ${prefix}
+                    bindir: ${exec_prefix}/bin
+                   sbindir: ${exec_prefix}/sbin
+                   lib_dir: ${exec_prefix}/lib
+               libexec_dir: ${exec_prefix}/libexec
+                    mandir: ${datarootdir}/man
+               datarootdir: ${prefix}/share
+                   datadir: ${datarootdir}
+   
+         fml process owner: fml
+         fml process group: fml
+                fmlconfdir: /etc/fml
+        ml_home_prefix_map: /etc/fml/ml_home_prefix
+                mlspooldir: /var/spool/ml
+            default domain: home.fml.org
+          default hostname: elena.home.fml.org
+   
+         mime based filter: yes
+   
+Now you must run "make install" as user "root".
+
+</screen>
+</para>
+
+<para>
+補足: いや、こういうタイプの設定をする OS の場合
+/usr/local ではなく /usr 直下に入れるですかね？
+<screen>
+# ./configure --prefix=/usr --with-fmlconfdir=/etc/fml
 </screen>
 </para>
 
@@ -247,16 +332,17 @@ Now you must run "make install".
           <entry>
 	基本設定ファイルを置く場所。
 	&fml4; の /usr/local/fml/.fml や default_config.ph を置く場所に
-	相当する。
+	相当します。
 	/usr/local/etc/fml/main.cf では、
-	バージョンやライブラリの場所(ディレクトリ)などを指定する。
+	使用する &fml8; のバージョンや
+	ライブラリの場所(ディレクトリ)などが指定可能です。
           </entry>
         </row>
 
         <row>
           <entry> /usr/local/libexec/fml 		</entry>
           <entry>
-	実行ファイル ( &fml4; の /usr/local/fml )
+	実行ファイル ( &fml4; の /usr/local/fml 相当)
 	  </entry>
         </row>
 
@@ -265,7 +351,7 @@ Now you must run "make install".
 		/usr/local/lib/fml
 	  </entry>
           <entry>
-	perl module 群を置く場所 ( &fml4; の /usr/local/fml )
+	perl module 群を置く場所 ( &fml4; の /usr/local/fml 相当)
 	  </entry>
         </row>
 
@@ -286,7 +372,7 @@ Now you must run "make install".
 	  </entry>
           <entry>
 		デフォルトドメインのＭＬ群のトップディレクトリ。
-		&fml4; と同じ目的に使われます。
+		&fml4; と同じ目的で使われます。
 
 		注意: /var/spool/ml のオーナは configure で指定した
 		owner 変数(デフォルトはユーザ fml)に設定されます。
@@ -300,9 +386,10 @@ Now you must run "make install".
 			バーチャルドメインの節
 			</link>
 			を参照
-		)に記述して下さい。
+		)に記述します(
+		makefml/fml の newdomain コマンドで設定されます)。
 
-		また、バーチャルドメインについて、くわしくは
+		バーチャルドメインの詳細は
 		<link linkend="virtualdomain">
 		<xref linkend="virtualdomain">
 		</link>
@@ -334,13 +421,14 @@ configure を実行後、ユーザ root になり、make install を実行して下さい。
 <warning>
 <para>
 configure はユーザ root で実行する必要はありませんが、
-make install はユーザ root で実行して下さい。
-間違えないように、configure も root で実行するほうがいいのかもしれません。
+make install は必ずユーザ root で実行して下さい。
 <screen>
 % su root
 # ./configure
 # make install
 </screen>
+間違えないように、はじめから 
+configure も root で実行するほうがいいのかもしれません。
 </para>
 </warning>
 
@@ -355,16 +443,15 @@ make install はユーザ root で実行して下さい。
 <para>
 必要なら /usr/local/etc/fml/main.cf を編集して下さい。
 
-configure が、あなたの環境に合わせて main.cf を書換えしているはずなの
-で configure のオプション指定が正しければ、編集の必要は、まずないはず
-です。
+configure が、あなたの環境に合わせて main.cf を書換えしているはずなので 
+configure のオプション指定が正しければ、編集の必要は、まずないはずです。
 </para>
 
 <para>
-mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
-通の fml の動作指定などは site_default_config.cf の役割です。各ＭＬ固
-有の設定は、各ＭＬのホームディレクトリにある config.cf ファイルを編集
-して下さい。
+mani.cf は大枠の最も基本的な設定です。より細かな設定、
+たとえばサイト共通の fml の動作指定などは site_default_config.cf の役割です。
+各ＭＬ固有の設定は、
+各ＭＬのホームディレクトリにある config.cf ファイルを編集して下さい。
 </para>
 
 <!-- main.cf の見本 -->
@@ -375,12 +462,12 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
 
 <sect1 id="install.fml.unix.edit.site.default.config.cf">
 	<title>
-	site_default_config.cf を編集する (オプショナル)
+	site_default_config.cf を編集する (オプション)
 	</title>
 
 <para>
-そのホスト共通の設定ファイルがあります。
-/usr/local/etc/fml/site_default_config.cf 
+/usr/local/etc/fml/site_default_config.cf  は、
+そのホスト共通の設定ファイル
 <footnote>
 <para>
 これは &fml4; の site_force.ph に相当するものです。
@@ -398,7 +485,7 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
 デフォルトでは &fml4; と合わせるために、および見本として:)
 subject のタグをつけない設定とフィルタ関連の設定だけが入っています。
 <screen>
-# $FML: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
+# $FML: fml_on_unix.sgml,v 1.13 2008/08/18 13:21:42 fukachan Exp $
 #
 #               site default_config.cf EXAMPLE
 #
@@ -449,21 +536,21 @@ use_mime_component_filter	=	yes
 </para>
 
 <para>
-まぁフィルタのかけすぎという見解もあるかもしれませんが、
-デフォルトは厳しい方にしてあります。
+「フィルタのかけすぎ」という見解もあるかもしれませんが、
+あえてデフォルトは厳しい設定にしてあります。
 </para>
 
 <para>
-フィルタがかかっているのはよいのですが、mime component filter のデフォ
-ルトをどうすれば良いのかは基準が曖昧です。デフォルトではＭＬへの投稿が
-許されるのは text/plain のメールのみとしてあります。これで text/html 
-な惚けメールも、添付ファイルで送られてくるウィルスもデフォルトでは通り
-ません。
+フィルタがかかっているのはよいのですが、
+mime component filter のデフォルトをどうすれば良いのかは基準が曖昧です。
+デフォルトではＭＬへの投稿が許されるのは text/plain のメールのみとして
+あります。これで text/html で送ってくる寝ぼけたメールも、
+添付ファイルで送られてくるウィルスもデフォルトでは通りません。
 </para>
 
 <para>
-(すべてのＭＬで)
- mime component filter を無効にするには
+なお、(すべてのＭＬで)
+mime component filter を無効にするには
 site_default_config.cf で
 <screen>
 use_mime_component_filter	=	no
@@ -472,9 +559,8 @@ use_mime_component_filter	=	no
 </para>
 
 <para>
-mime component filter を有効にしたいが、
-ルールをカスタマイズしたいという場合は
-site_default_config.cf は
+mime component filter を有効にしたいがルールをカスタマイズしたいという場合、
+site_default_config.cf では
 <screen>
 use_mime_component_filter	=	yes
 </screen>
@@ -506,9 +592,14 @@ use_mime_component_filter	=	no
 	</title>
 
 <para>
-そのドメインでのＭＬを作る前に、newdomain コマンドで 
+最初に(つまり、そのドメインでＭＬを作る前に)、newdomain コマンドで 
 ml_home_prefix_maps に利用したいドメインと ml_home_prefix の対応関係を
 定義してください。
+<screen>
+[/var/spool/ml/etc/fml/ml_home_prefix]
+
+nuinui.net /var/spool/nuinui.net
+</screen>
 newdomain コマンドについては
 <link linkend="setup.newml">
 「ＭＬの作成」
@@ -518,13 +609,15 @@ newdomain コマンドについては
 
 <warning>
 <para>
-ml_home_prefix_maps のパスを変更したいなら別ですが、
-/usr/local/etc/fml/main.cf の編集は必要ありません。
+ml_home_prefix_maps のパスを変更したい場合は
+/usr/local/etc/fml/main.cf を編集して下さい
+(もっとも、たいてい、編集は不要です)。
 </para>
 
 <para>
-site_default_config.cf はドメインに関わらず適用されることに注意してく
-ださい。バーチャルドメインにも適用されます。
+なお、
+site_default_config.cf はドメインに関わらず適用されることに注意してください。
+つまり、この設定はバーチャルドメインにも適用されます。
 </para>
 </warning>
 
@@ -538,7 +631,7 @@ site_default_config.cf はドメインに関わらず適用されることに注意してく
 <!-- recipes -->
 <sect1 id="install.recipes">
 	<title> 
-	recipes
+	レシピ’s
 	</title> 
 
 	<!-- TABLE_OF_RECIPES -->
diff --git a/fml/doc/ja/tutorial/install/postfix.sgml b/fml/doc/ja/tutorial/install/postfix.sgml
index d3b2f122..55cf7382 100644
--- a/fml/doc/ja/tutorial/install/postfix.sgml
+++ b/fml/doc/ja/tutorial/install/postfix.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: postfix.sgml,v 1.6 2005/06/25 15:11:32 fukachan Exp $
+   $FML: postfix.sgml,v 1.7 2008/08/18 13:21:42 fukachan Exp $
 -->
 
 
@@ -8,19 +8,40 @@
 	メールサーバの設定 (Postfix)
 	</title>
 
+<caution>
 <para>
-makefml newml を実行するだけでＭＬが自動的に有効になるように、
-次のように Postfix の設定を変更して下さい。
+[ナビゲーション] Postfix 設定変更点のまとめ
+<screen>
+[/etc/postfix/main.cf]
+
+(1) allow_mail_to_commands	(最初に一回だけ)
+
+(2) alias_maps	へ追加		(ドメインごとに一回)
+
+(3) virtual_maps へ追加		(バーチャルドメインごとに一回)
+</screen>
+ＭＬごとには「無し」です(ＭＬの新規作成・削除に伴う Postfix の変更は不要)。
+</para>
+</caution>
+
+<para>
+あらかじめ次のように Postfix の設定を変更しておいて下さい。
+こうしておけば
+makefml newml (fml ML newml)を実行するだけでＭＬが自動的に有効になります。
 </para>
 
 <caution>
+
 <para>
-一つのドメインについては、一度 Postfix の設定をすれば、あとは makefml 
-ないしは fml コマンドの操作だけでＭＬの作成、削除が可能になりますが、
-別のドメインを使うなら、ドメインごとに Postfix の alias_maps と 
+複数のドメインを使う場合、ドメインごとに Postfix の alias_maps と 
 virtual_maps の追加設定が必要になることに注意して下さい。
 </para>
 
+<para>
+ただし、最初の一回だけでＯＫです。
+一つのドメインについては、一度 Postfix の設定をすれば、あとは 
+makefml ないしは fml コマンドの操作だけでＭＬの作成・削除が可能です。
+</para>
 
 </caution>
 
@@ -35,7 +56,7 @@ virtual_maps の追加設定が必要になることに注意して下さい。
 allow_mail_to_commands = alias,forward,include
 </screen>
 の設定を入れて下さい。
-これはＭＬドライバを実行するためにどんなケースでも必須の設定です。
+これはＭＬドライバを実行するために必須の設定です。
 </para>
 
 </sect2>
@@ -43,25 +64,29 @@ allow_mail_to_commands = alias,forward,include
 
 <sect2>
 	<title>
-	デフォルトのドメイン(例: fml.org)
+	デフォルト・ドメイン(例: fml.org)用のＭＬ設定
 	</title>
 
 
 <para>
-具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。
+具体的には postfix の /etc/postfix/main.cf を次のようにしてください。
 <screen>
+[/etc/postfix/main.cf]
+
 # Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
+# /etc/mail/aliases は OS デフォルトの alias
+# /var/spool/ml/etc/mail/aliases はデフォルトドメイン用の alias (fml 管理) 
 alias_maps	=	hash:/etc/mail/aliases
 			hash:/var/spool/ml/etc/mail/aliases
 </screen>
 hash:/var/spool/ml/etc/mail/aliases は 
-「デフォルトのＭＬスプール/etc/mail/aliases」です。
+「デフォルトのＭＬスプール/etc/mail/aliases」です(
+デフォルトのＭＬスプール・パスはインストール設定によって変わります)。
 CUI で newml コマンドを実行すると、画面上で
 hash:/var/spool/ml/etc/mail/aliases 
-ファイルをアップデートしていることが表示されるのでパスを確認してみて下
-さい。
+ファイルをアップデートしていることが表示されるのでパスを確認してみて下さい。
 newml コマンドの使い方についての詳細は
 <link linkend="install.fml.unix">
 <xref linkend="install.fml.unix">
@@ -70,7 +95,7 @@ newml コマンドの使い方についての詳細は
 </para>
 
 <!--
-XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
+XXX-TODO: newml の際に、Postfix 設定のヒントを表示するべきでしょう。
 -->
 
 <warning>
@@ -78,6 +103,13 @@ XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
 また mydestination にデフォルトのドメイン(おそらく $mydomain )が
 ちゃんと追加されていることを確認して下さい。
 </para>
+
+<para>
+<screen>
+% postconf mydestination
+</screen>
+を実行し、Postfix の設定を確認。
+</para>
 </warning>
 
 </sect2>
@@ -92,13 +124,17 @@ XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
 /etc/postfix/main.cf で
 alias_maps と virtual_maps の両方に設定の追加が必要です。
 <screen>
+[/etc/postfix/main.cf]
+
 # Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
+# nuinui.net 用の alias を追加
 alias_maps	=	hash:/etc/mail/aliases
 			hash:/var/spool/ml/etc/mail/aliases
 			hash:/var/spool/nuinui.net/etc/mail/aliases
 
+# nuinui.net 用の virtual (バーチャルドメインの扱い方の指示)を追加
 virtual_maps	=	hash:/var/spool/nuinui.net/etc/postfix/virtual
 
 </screen>
@@ -106,13 +142,20 @@ makefml newml を実行すると
 /var/spool/nuinui.net/etc/mail/aliases
 および
 /var/spool/nuinui.net/etc/postfix/virtual 
-は makefml によって自動的に更新されます(画面に表示されるので分かるはず)。
-なお、この場合、事前に ml_home_prefix_maps で
+は makefml によって自動的に更新されます(画面に表示されるので分かりますね？)。
+</para>
+
+<para>
+バーチャルドメインの場合、事前に ml_home_prefix_maps の設定が必要です。
+この例では ml_home_prefix_maps で
 <screen>
+[/var/spool/ml/etc/fml/ml_home_prefix]
+
 nuinui.net /var/spool/nuinui.net
 </screen>
 という「ドメイン←→ディレクトリ」の定義がなされています。
-newml コマンドの使い方についての詳細は
+これは newdomain コマンドで設定します。
+詳細は
 <link linkend="install.fml.unix">
 <xref linkend="install.fml.unix">
 </link>
diff --git a/fml/doc/ja/tutorial/install/qmail.sgml b/fml/doc/ja/tutorial/install/qmail.sgml
index 3675f485..052765b0 100644
--- a/fml/doc/ja/tutorial/install/qmail.sgml
+++ b/fml/doc/ja/tutorial/install/qmail.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: qmail.sgml,v 1.5 2004/10/06 09:07:37 fukachan Exp $
+   $FML: qmail.sgml,v 1.6 2008/08/19 03:22:17 fukachan Exp $
 -->
 
 
@@ -11,44 +11,123 @@
 <warning>
 <para>
 &fml8; の qmail 設定は、
-バーチャルドメインなのかデフォルトのドメインなのか？を問わず、
-常に
+バーチャルドメインなのかデフォルト・ドメイン(のみ)なのか？を問わず、
+つねに
 /var/qmail/control/virtualdomains
 の利用を前提としています。
+&fml4; の流儀とは異なりますので注意して下さい。
 </para>
+
+<para>
+[ナビゲーション] qmail 設定変更点のまとめ
+<screen>
+(1) 新ドメインを使い始める初回に newdomain (makefml もしくは fml コマンド)
+
+(2) newml で、ひとつＭＬを作成してみる(makefml もしくは fml コマンド)
+
+(3) 作成された見本を元に、/var/qmail/control/virtualdomains を編集。
+    見本は「newdomainで指定したスプール名」/etc/qmail/virtualdomains 。
+
+(4) qmail-send に HUP シグナル。
+</screen>
+ＭＬごとには「無し」です
+(ＭＬの新規作成・削除に伴う qmail の設定変更は不要)。
+</para>
+
 </warning>
 
 <para>
-makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
-め qmail の設定を変更しておいて下さい。
+makefml newml ないしは fml ML newml
+を実行するだけでＭＬが自動的に有効となるように、
+あらかじめ qmail の設定を変更しておいて下さい。
 /var/qmail/control/virtualdomains の設定見本は
 (ドメインごとに) /var/spool/ml/etc/qmail に作成されます。
 </para>
 
+<para>
+以下、そのドメインの最初のＭＬを作る際に必要な手順について説明します。
+</para>
+
 
 <sect2>
 	<title>
-	デフォルトのドメイン(例: fml.org)の場合
+	デフォルトのドメイン(例: example.org)の場合
 	</title>
 
 <para>
-デフォルトのドメイン(例: fml.org)は使えないと思うのですが、嘘？
-ml.fml.org などとＭＬ専用のサブドメインを作って使うのが良いと思ってい
-ます。
+デフォルトのドメイン(例: example.org)は使えないと思うのですが、嘘？
+</para>
+
+<para>
+デフォルトドメインではなく、
+ml.example.org などとＭＬ専用のサブドメインを作って使うのが良いと思っています。
 </para>
 
 <para>
+→ 次節へ:
+</para>
+
+<caution>
+<para>
+デフォルトドメインに対しては
+/var/qmail/control/virtualdomains
+の見本(例: /var/spool/ml/etc/qmail/virtualdomains)も”作成されません”。
+</para>
+</caution>
+
+</sect2>
+
+
+<sect2>
+	<title>
+	バーチャルドメイン(例: ml.example.org)
+	</title>
+
+<para>
+ml.example.org での最初のＭＬを作成する際に
+qmail の virtualdomains ファイルの見本が作成されます。
+それを見て、
 <screen>
 /var/qmail/control/virtualdomains
 </screen>
-に、あらかじめ次のような設定を仕込んでおけば、
-makefml newml を実行するだけで自動的にＭＬが有効になります。
+を編集してください。
+また、そのドメインを /var/qmail/control/rcpthosts にも追加してください。
 <screen>
-ml.fml.org:fml-ml.fml.org
+[/var/qmail/control/rcpthosts]
+
+ml.example.org
 </screen>
 </para>
 
 <para>
+各ドメインごとに、初回に一回 
+/var/qmail/control/virtualdomains と
+/var/qmail/control/rcpthosts 
+を編集すれば、あとは全自動でＭＬ新規作成・削除が行なえるようになります。
+</para>
+
+<para>
+例( qmail 1.03 on NetBSD/i386 5.0.2 ):
+<screen>
+% su root
+# makefml newdomain ml.example.org /var/spool/ml.example.org
+# su fml
+% makefml newml test@ml.example.org
+  ... 出力 ...
+% exit
+# echo ml.example.org >> /var/qmail/control/rcpthosts
+# cat /var/spool/ml.example.org/etc/qmail/virtualdomains \
+      >> /var/qmail/control/virtualdomains
+# pkill -HUP qmail-send (qmail-send に HUP シグナルを送る)
+</screen>
+注意:
+/var/qmail/control/virtualdomains を制御しているのは qmail-send です。
+qmail-send はスタートする際にのみ virtualdomains ファイルを読み込みます。
+virtualdomains ファイルを再読み込みさせるためには
+qmail-send に HUP シグナルを送る必要があります。
+</para>
+
+<para>
 makefml newml が作るファイル名については
 <link linkend="setup.qmail.aliases">
 makefml newml の qmail に関する節
@@ -56,20 +135,26 @@ makefml newml の qmail に関する節
 を参照してください。
 </para>
 
-</sect2>
-
-
-<sect2>
-	<title>
-	バーチャルドメイン(例: nuinui.net)
-	</title>
-
 <para>
-nuinui.net ドメインのＭＬは
+qmail の設定の要点は
 <screen>
-nuinui.net:fml-nuinui.net
+/var/qmail/control/virtualdomains
+</screen>
+に、あらかじめ次のような設定
+<screen>
+ml.example.org:fml-ml.example.org
 </screen>
-などとしてください。
+を仕込んでおけば、
+makefml ないしは fml コマンドが、
+このバーチャルドメインに該当する ~fml/.qmail-* ファイル群を生成するので、
+これだけでＭＬ設定が有効になる、というところです。
+</para>
+
+<para>
+ま、root で qmail の設定を修整する必要があるのは他のＭＴＡと一緒なので、
+とりたてて楽とかいうことはないですね。
+.qmail-* ファイル群を自動化したから気にしてないけど、
+毎回一から書いたら気が(ピー)そうです。
 </para>
 
 </sect2>
diff --git a/fml/doc/ja/tutorial/install/recipes.sgml b/fml/doc/ja/tutorial/install/recipes.sgml
index 257a72ae..8f532f11 100644
--- a/fml/doc/ja/tutorial/install/recipes.sgml
+++ b/fml/doc/ja/tutorial/install/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML: recipes.sgml,v 1.2 2008/08/18 13:21:42 fukachan Exp $
+ $FML: recipes.sgml,v 1.3 2008/08/23 00:59:51 fukachan Exp $
 -->
 
 <qandaset>
@@ -9,25 +9,29 @@
 
 <question>
 <para>
-ユーザ fml 以外(例えば自分)で fml を使いたい
+ユーザ fml 以外(たとえば自分名義)で fml を使いたい
 </para>
 </question>
 
 <answer>
 <para>
-fml を動かすプロセスのユーザ fml を他のユーザにしたいのであれば、
+fml を動かすプロセスのユーザ fml を
+他のユーザ(たとえば another)にしたいのであれば、
 configure オプションの  --with-fml-owner で変更できます。
+<screen>
+./configure --with-fml-owner=another
+</screen>
 </para>
 
 <para>
-自分のアカウントで実行するのはやめましょう。fml 専用ユーザを用意するこ
-とが推奨です。
+ただ、自分のアカウントで実行するのはやめましょう。
+fml 専用ユーザを用意することが推奨です。
 </para>
 
 <para>
 aliases からの起動ではなく、
 一般ユーザの権限としてＭＬを実行するのであれば
-procmail の利用を考えてみて下さい。
+procmail の利用を考えてみるのも一つの手でしょう。
 設定は /var/spool/ml/etc/procmail/procmailrc を参考にして下さい。
 </para>
 </answer>
@@ -39,7 +43,7 @@ procmail の利用を考えてみて下さい。
 
 <question>
 <para>
-インストールの際にユーザ fml になるタイミングは？
+インストール作業の際、ユーザ fml になるタイミングは？
 </para>
 </question>
 
@@ -50,7 +54,8 @@ procmail の利用を考えてみて下さい。
 </para>
 
 <para>
-ダウンロードからインストールまで全てユーザ root で行なっても問題ありません。
+逆に、すべての作業(ダウンロードからインストールまですべて)を
+ユーザ root で行なっても問題ありません。
 </para>
 </answer>
 
@@ -67,9 +72,11 @@ procmail の利用を考えてみて下さい。
 
 <answer>
 <para>
-現在、&fml8; はドキュメントをインストールしません。 逆に、ドキュメント
-が必要ならソースの Documentation/ 以下を適切な場所(たとえば 
-/usr/local/share/doc/fml8/バージョン番号/)にコピーして下さい。
+現在、&fml8; はドキュメントをインストールしません。 
+逆に、ドキュメントが必要ならソースの 
+Documentation/ 以下を適切な場所
+(たとえば /usr/local/share/doc/fml8/バージョン番号/)
+にコピーして下さい。
 </para>
 </answer>
 
@@ -107,7 +114,7 @@ jperl で fml を使いたい
 
 <answer>
 <para>
-動くかどうかまったく分かりません。
+動くかどうか、まったく分かりません。
 </para>
 </answer>
 
@@ -164,7 +171,7 @@ elena ML を上書き(再生成)したい
 
 <answer>
 <para>
-注意: テストしていないです。
+注意: テストしていません。
 </para>
 
 <para>
@@ -199,35 +206,35 @@ MTA を Unix で動かせば良いでしょう。
 
 <qandaentry>
 <question>
-	<para>
-	間違えて rmml してしまったＭＬを復活させたい
-	</para>
+<para>
+間違えて rmml してしまったＭＬを復活させたい
+</para>
 </question>
 
 <answer>
-	<para>
-	reviveml コマンドを使って下さい。
-	</para>
+<para>
+reviveml コマンドを使って下さい。
+</para>
 </answer>
 </qandaentry>
 
 
 <qandaentry>
 <question>
-	<para>
-	loader や Bootstrap() がど〜っとかいうエラーが出る
-	</para>
+<para>
+loader や Bootstrap() がど〜っとかいうエラーが出る
+</para>
 </question>
 
 <answer>
 <para>
-ブートストラップのやり方がまだ収束してないので、稀に
+ブートストラップのコードがまだ収束してないので、まれに
 fml の boot loader (/usr/local/fml/libexec/loader)
-を入れ替える必要がある時があります。
+を入れ替える必要があることもありえます。
 </para>
 
 <para>
-そういう場合は、make install 時に
+そういった場合は、make install 時に
 <screen>
 You must upgrade loader. Replace it ? [y/n]
 </screen>
diff --git a/fml/doc/ja/tutorial/install/upgrade.sgml b/fml/doc/ja/tutorial/install/upgrade.sgml
index a9c67b1c..a350562f 100644
--- a/fml/doc/ja/tutorial/install/upgrade.sgml
+++ b/fml/doc/ja/tutorial/install/upgrade.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: upgrade.sgml,v 1.8 2005/06/25 15:11:33 fukachan Exp $
+   $FML: upgrade.sgml,v 1.9 2008/08/18 13:21:42 fukachan Exp $
 -->
 
 
@@ -11,8 +11,7 @@
 <warning>
 
 <para>
-本章では &fml8; のバージョンをアップグレード/ダウングレードする方法につ
-いて解説します。
+本章では &fml8; をアップグレード/ダウングレードする方法について解説します。
 </para>
 
 <para>
@@ -54,7 +53,7 @@ main.cf を編集した瞬間にアップグレードが有効になります。
 </para>
 
 <para>
-逆に言えば、fml_version 行を編集するまでアップグレードは有効にはなりません。
+逆に言えば fml_version 行を編集するまでアップグレードは有効にはなりません。
 </para>
 
 </sect1>
@@ -72,8 +71,8 @@ main.cf を編集した瞬間にアップグレードが有効になります。
 </para>
 
 <para>
-ファイルをセーブした瞬間に古い(かつてインストールした任意のバージョン
-の) fml に切り替わります(注: エディタで編集中は古い内容)。
+ファイルをセーブした瞬間に古い(かつてインストールした任意のバージョンの) 
+fml に切り替わります(注: エディタで編集中は古い内容)。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/internals/cgi.sgml b/fml/doc/ja/tutorial/internals/cgi.sgml
index 7fe86a68..6797c6f0 100644
--- a/fml/doc/ja/tutorial/internals/cgi.sgml
+++ b/fml/doc/ja/tutorial/internals/cgi.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: cgi.sgml,v 1.14 2005/06/25 15:11:33 fukachan Exp $
+   $FML: cgi.sgml,v 1.15 2009/12/26 13:33:26 fukachan Exp $
 -->
 
 
@@ -179,7 +179,7 @@ Mach のトランポリン機構のように、いったりきたりしています。
 	</title>
 
 <para>
-例えば FML::CGI::Admin::User では
+たとえば FML::CGI::Admin::User では
 $comname と maps の関係がハードコーディングされてるけれど、
 でも、これはある程度はしかたないでしょう。
 </para>
diff --git a/fml/doc/ja/tutorial/internals/db_modules.sgml b/fml/doc/ja/tutorial/internals/db_modules.sgml
index de4aec68..883e3423 100644
--- a/fml/doc/ja/tutorial/internals/db_modules.sgml
+++ b/fml/doc/ja/tutorial/internals/db_modules.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: db_modules.sgml,v 1.4 2008/08/18 13:21:42 fukachan Exp $
+   $FML: db_modules.sgml,v 1.5 2009/12/26 13:33:26 fukachan Exp $
 -->
 
 <!--
@@ -138,7 +138,7 @@ DBMS
 
 <para>
 このクラスは、サイズを度外視して一定期間のあいだ記録しておきたいデータ
-に対して使います。例えば、登録時の confirmation のキャッシュや
+に対して使います。たとえば、登録時の confirmation のキャッシュや
 message-id キャッシュです。これらは expire を時間で制御したいからです。
 このクラスは引数でファイル名を与えることになっているので、ファイル名に
 日付つきのファイルを選ぶと良いでしょう。
diff --git a/fml/doc/ja/tutorial/internals/design.sgml b/fml/doc/ja/tutorial/internals/design.sgml
index 1351c286..26aee7af 100644
--- a/fml/doc/ja/tutorial/internals/design.sgml
+++ b/fml/doc/ja/tutorial/internals/design.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: design.sgml,v 1.12 2008/07/12 12:53:05 fukachan Exp $
+   $FML: design.sgml,v 1.13 2010/03/18 20:28:04 fukachan Exp $
 -->
 
 
@@ -230,7 +230,7 @@ mead (エラーメール解析プログラム)などは輸出可能な例でしょう。
 		可能な限りあらゆる CPAN モジュールなどを使う。
 
 		そして利用する場合には乖離層を設けること。
-		例えば
+		たとえば
 		”FML::モジュール →  乖離層 → CPAN/モジュール”
 		のように。
 	</entry>
@@ -310,7 +310,7 @@ mead (エラーメール解析プログラム)などは輸出可能な例でしょう。
 
 		(と、最初はいっていたけど、結局つかってます:-)
 
-		そのスクリプトは例えば
+		そのスクリプトは、たとえば
 		IPv6 ready か否かを決めるために使われるだろう(
 		現在の実装では使ってはいない、IPv6 は常に挑戦してみる
 		)。
diff --git a/fml/doc/ja/tutorial/internals/filename.sgml b/fml/doc/ja/tutorial/internals/filename.sgml
index 8827e45e..a3e806cd 100644
--- a/fml/doc/ja/tutorial/internals/filename.sgml
+++ b/fml/doc/ja/tutorial/internals/filename.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: filename.sgml,v 1.4 2004/10/06 09:07:39 fukachan Exp $
+   $FML: filename.sgml,v 1.5 2010/03/18 20:28:04 fukachan Exp $
 -->
 
 
@@ -26,7 +26,8 @@
 <screen>
 ファイル名-役割
 </screen>
-です。例えば、配送リストは次のようになります。
+です。
+たとえば、配送リストは次のようになります。
 <screen>
 recipients-役割
 members-役割
diff --git a/fml/doc/ja/tutorial/internals/filter.sgml b/fml/doc/ja/tutorial/internals/filter.sgml
index dd14d289..9b3d6c32 100644
--- a/fml/doc/ja/tutorial/internals/filter.sgml
+++ b/fml/doc/ja/tutorial/internals/filter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: filter.sgml,v 1.11 2008/08/19 03:22:17 fukachan Exp $
+   $FML: filter.sgml,v 1.12 2010/03/18 20:28:04 fukachan Exp $
 -->
 
 
@@ -509,8 +509,9 @@ text/plain + text/plain + text/html
 </screen>
 で、アンケートの結果をまとめると、通常は (1) を使う。これは決まりみた
 いです。規模とポリシー(きびしくできるか否かなど)によって(2)もアリかも
-しれない。例えば社内ＭＬのようにメールの型を厳しくできないＭＬは、そも
-そも mime component filter を on にしないというわけです。
+しれない。
+たとえば社内ＭＬのようにメールの型を厳しくできないＭＬは、
+そもそも mime component filter を on にしないというわけです。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/internals/restriction.sgml b/fml/doc/ja/tutorial/internals/restriction.sgml
index 2996f41b..2c3439dc 100644
--- a/fml/doc/ja/tutorial/internals/restriction.sgml
+++ b/fml/doc/ja/tutorial/internals/restriction.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: restriction.sgml,v 1.11 2008/08/18 20:52:59 fukachan Exp $
+   $FML: restriction.sgml,v 1.12 2010/03/18 20:28:05 fukachan Exp $
 -->
 
 
@@ -128,7 +128,7 @@ FML::Restriction クラス以下にモジュールを配置することにしています。
 </para>
 
 <para>
-例えば、CGI では
+たとえば、CGI では
 FML::Restriction::CGI クラスのモジュールを用いて
 入力データがある正規表現の中に収まるかどうか？の検査をしています。
 </para>
diff --git a/fml/doc/ja/tutorial/message/discussion.sgml b/fml/doc/ja/tutorial/message/discussion.sgml
index bb8ea8de..65ee1391 100644
--- a/fml/doc/ja/tutorial/message/discussion.sgml
+++ b/fml/doc/ja/tutorial/message/discussion.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: discussion.sgml,v 1.7 2008/08/19 03:16:56 fukachan Exp $
+   $FML: discussion.sgml,v 1.8 2010/03/18 20:28:05 fukachan Exp $
 -->
 
 
@@ -42,7 +42,7 @@ Mesg() は /usr/local/fml/messages/Japanese/ 以下にあるファイル群に対し
 </para>
 
 <para>
-例えば、キーワードが not_found の場合、
+たとえば、キーワードが not_found の場合、
 /usr/local/fml/messages/Japanese/kern
 ファイルの not_found という欄が該当します。
 </para>
diff --git a/fml/doc/ja/tutorial/message/language.sgml b/fml/doc/ja/tutorial/message/language.sgml
index 5ef79bc0..3cf8b4fa 100644
--- a/fml/doc/ja/tutorial/message/language.sgml
+++ b/fml/doc/ja/tutorial/message/language.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: language.sgml,v 1.8 2008/08/19 03:16:56 fukachan Exp $
+   $FML: language.sgml,v 1.9 2010/03/18 20:28:05 fukachan Exp $
 -->
 
 
@@ -32,7 +32,7 @@ $curproc->reply_message_nl('error.already_member',
 </para>
 
 <para>
-メッセージ中の $_arg_変数名、例えば、
+メッセージ中の $_arg_変数名、たとえば、
 <screen>
 $_arg_address
 </screen>
diff --git a/fml/doc/ja/tutorial/module/IO.sgml b/fml/doc/ja/tutorial/module/IO.sgml
index 518df072..328ebd12 100644
--- a/fml/doc/ja/tutorial/module/IO.sgml
+++ b/fml/doc/ja/tutorial/module/IO.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: IO.sgml,v 1.6 2008/08/19 03:16:57 fukachan Exp $
+   $FML: IO.sgml,v 1.7 2010/03/18 20:28:05 fukachan Exp $
 -->
 
 <chapter id="module.io.adapter">
@@ -22,7 +22,7 @@ LDAP など、さまざまな形式で管理できます。
 </para>
 
 <para>
-&fml8; でのメンバーリストの読み書き、例えばアドレスの登録/削除は
+&fml8; でのメンバーリストの読み書き、たとえばアドレスの登録/削除は
 IO::Adapter という抽象クラスを通じて行ないます。ようは Unix で 
 vfs/vnode インターフェイスを導入した時のような感じですね。
 使い方は次のようになります。
diff --git a/fml/doc/ja/tutorial/module/Message.sgml b/fml/doc/ja/tutorial/module/Message.sgml
index f76444a6..84875e9d 100644
--- a/fml/doc/ja/tutorial/module/Message.sgml
+++ b/fml/doc/ja/tutorial/module/Message.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: Message.sgml,v 1.4 2008/08/19 03:16:57 fukachan Exp $
+   $FML: Message.sgml,v 1.5 2010/03/18 20:28:05 fukachan Exp $
 -->
 
 <chapter id="module.mail.message">
@@ -69,7 +69,7 @@ parse() メソッドは引数で与えられたファイル(名)かファイルディスクリプタ
 
 <para>
 data_type_list() は鎖の列の情報を返します。情報は ARRAY REFERENCE の形
-で返されます。例えば MIME/Multipart は次のように表現されています
+で返されます。たとえば MIME/Multipart は次のように表現されています
 (ちなみに、以下の表示はデバッグモードで出力されるものです)。
 <screen>
   type[ 1]: text/rfc822-headers       | multipart/mixed
@@ -341,7 +341,7 @@ num_paragraph()
 nth_paragraph(数字)
 メソッドは
 「数字」番目のパラグラフの内容を文字列として返します。
-例えば、一番目のパラグラフは 0 ではなく 1 と指定して下さい。
+たとえば、一番目のパラグラフは 0 ではなく 1 と指定して下さい。
 ここは、わざとＣ言語風ではなく人間に分かりやすいように
 「 1から始まる仕様」としてあります。
 </para>
diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml
index 8186e712..0cc78644 100644
--- a/fml/doc/ja/tutorial/overview/fml.sgml
+++ b/fml/doc/ja/tutorial/overview/fml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fml.sgml,v 1.12 2008/08/19 03:22:17 fukachan Exp $
+   $FML: fml.sgml,v 1.13 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -21,13 +21,12 @@
 <!-- ======================================================== -->
 <sect1 id="overview.fml8">
 	<title>
-	&fml8; でできること
+	&fml8; で出来ること
 	</title>
 
 <para>
 &fml4; の再実装にあたっての山場は越えたと思います。
-CGI 関係以外は RC (Release Candidate) の気分…
-あぁ、うそ makefml config ができてない。
+メニュー関連項目以外は RC (Release Candidate) の気分です。
 </para>
 
 <para>
@@ -49,7 +48,7 @@ CGI 関係以外は RC (Release Candidate) の気分…
     <listitem>
 	<para>
 	<link linkend="usage.onhost">
-	makefml によるコマンド操作
+	シェル上でのコマンド(makefml なしいは fml)による操作
 	</link>
 	は &fml4; と同様です:
 		ＭＬの作成/削除、
@@ -110,7 +109,7 @@ CGI 関係以外は RC (Release Candidate) の気分…
 	コマンドメール(リモート管理者):
 		メンバーの登録/削除/変更(chaddr)、
 		リモート管理者の登録/削除、
-		ログを見る、
+		ログを見る。
 	</para>
     </listitem>
 
@@ -134,7 +133,7 @@ CGI 関係以外は RC (Release Candidate) の気分…
 
     <listitem>
 	<para>
-	IPv6 による配送
+	IPv6 による配送。
 	</para>
     </listitem>
 
@@ -185,8 +184,8 @@ CGI 関係以外は RC (Release Candidate) の気分…
 	</para>
 
 	<para>
-	注意: ただし、代表的な機能だけで、全ての変数の互換性があるわけ
-	ではありません。
+	注意: ただし、代表的な機能だけで、
+	全機能に対する互換性があるわけではありません。
 	</para>
     </listitem>
 
@@ -194,7 +193,7 @@ CGI 関係以外は RC (Release Candidate) の気分…
     <listitem>
 	<para>
 	2004 夏以降: 配送キュー管理システムにより再送処理。
-	事実上 MTA の役割をしています。
+	事実上 &fml8; は MTA です。
 	</para>
     </listitem>
 
@@ -204,8 +203,9 @@ CGI 関係以外は RC (Release Candidate) の気分…
 	<link linkend="module.io.adapter">
 	抽象化 IO 層
 	</link>
-	メンバーファイルをファイル、/etc/group, NIS, MySQL
-	から取り出すことができます。
+	メンバーリストなどの取り扱いにおいて、
+	ファイル、/etc/group、 NIS、MySQL、PostgreSQL、LDAP などを
+	同列に扱います(設定ファイルに追加設定は必要)。
 	</para>
     </listitem>
     </itemizedlist>
@@ -226,15 +226,15 @@ CGI 関係以外は RC (Release Candidate) の気分…
 <para>
 インスール方法は GNU autoconf を使うデファクトスタンダード(configure 
 そして make)なものとなっています。&fml4; にあまり似ていません。ですが、
-OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
+OS 附属のパッケージシステムとの親和性は高くなりました。
 </para>
 
 <para>
 &fml8; のインストールにおける主な注意点(&fml4;との相違点)は、
 「root での作業」、
 「configure の使用」、
-/usr/local/etc/fml/
-のファイル編集です。
+「/usr/local/etc/fml/ 以下にあるファイルの編集」
+です。
 <footnote>
 <para>
 &fml8; の
@@ -244,7 +244,7 @@ OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 /usr/local/fml/.fml 以下のファイル群
 および
 /usr/local/etc/fml/site_default_config.ph
-などに相当していますが、必ずしも一対一対応するわけではありません。
+などに相当していますが、必ずしも一対一対応しているわけではありません。
 </para>
 </footnote>
 </para>
@@ -253,8 +253,9 @@ OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 
 
 <para>
-さて、いつものように Unix 上で elena ＭＬ(elena@fml.org)を作成するケー
-スを例にとりましょう。インストールのおおまかな流れは次のようになります。
+さて、いつものように 
+Unix 上で elena ＭＬ(elena@fml.org)を作成するケースを例にとりましょう。
+インストールのおおまかな流れは次のようになります。
 </para>
 
 
@@ -295,7 +296,7 @@ OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 	<link linkend="install.fml.unix.configure">
 	configure のオプション
 	</link>
-	で変更が可能です。
+	で変更可能です。
 	</para>
 
 	<para>
@@ -357,7 +358,7 @@ OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 
 <warning>
 <para>
-&fml4; と異なり root でインストールすることに注意して下さい。
+&fml4; と異なりユーザ root でインストール作業をすることに注意して下さい。
 </para>
 </warning>
 
@@ -372,7 +373,7 @@ OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 
 <para>
 makefml コマンドを使ってＭＬを作成します。
-デフォルトのドメイン(例: fml.org)の場合、
+デフォルト・ドメイン(例: fml.org)の場合、
 makefml の使い方は &fml4; の時と同様です。
 elena@fml.org ＭＬを作るには
 <screen>
@@ -392,7 +393,7 @@ elena@fml.org ＭＬを作るには
 <link linkend="virtualdomain">
 バーチャルドメイン(nuinui.net)
 </link>
-の場合は、ＭＬのアドレスを全部指定して下さい。
+の場合は、ＭＬのアドレスをすべて指定して下さい。
 たとえば elena@nuinui.net を作る場合は、次のように実行します。
 <screen>
 初回
@@ -408,14 +409,17 @@ elena@fml.org ＭＬを作るには
 </para>
 
 <para>
-いまどき一人で複数ドメインを持つなんて普通だと思うので、全ＭＬをバーチャ
-ルドメインにしておくほうが統一感があって良いと思いますね。
+最近では、一人で複数のドメインを持つことはありふれていますので、
+全ＭＬをバーチャルドメインとして作成するほうが統一感のある運用方式になる
+と思われます。
+実際 fml.org 自身もそのような運用方式です。
 </para>
 
 <warning>
 <para>
-バーチャルドメイン(nuinui.net)のＭＬを作る場合、最初の一回目には、「そ
-のドメインを使う」ための宣言(おまじない?)が必要です。くわしくは
+バーチャルドメイン(nuinui.net)のＭＬを作る場合、最初の一回目には、
+「そのドメインを使う」ための宣言(おまじない?)が必要です。
+くわしくは
 <link linkend="virtualdomain">
 <xref linkend="virtualdomain">
 </link>
@@ -438,9 +442,9 @@ elena@fml.org ＭＬを作るには
 % su fml
 % makefml subscribe elena rudo@nuinui.net
 </screen>
-で構いません。
+でＯＫです(elena だけでＯＫ、つまり @fml.org なしでもＯＫ)。
 一方、バーチャルドメイン(nuinui.net)の場合は、
-ＭＬのアドレスを全部指定して下さい。
+ＭＬのアドレスをすべて指定して下さい。
 <screen>
 % su fml
 % makefml subscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp
@@ -462,9 +466,9 @@ elena@fml.org ＭＬを作るには
 % su fml
 % makefml unsubscribe elena rudo@nuinui.net
 </screen>
-で構いません。
+でかまいません。
 一方、バーチャルドメイン(nuinui.net)の場合は、
-アドレスを全部指定して下さい。
+アドレスをドメインまで含めてすべて指定して下さい。
 <screen>
 % su fml
 % makefml unsubscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp
@@ -477,13 +481,13 @@ elena@fml.org ＭＬを作るには
 <!-- ============================================================= -->
 <sect1 id="guide.config.cf">
 	<title>
-	ＭＬの設定のカスタマイズ
+	ＭＬ設定のカスタマイズ
 	</title>
 
 <warning>
 <para>
 makefml config は実装途中で、まだイマイチです。ごめんなさい。
-いまは、まだ config.cf ファイルを手で編集して下さい。
+いまは、まだ config.cf ファイルを手動で編集して下さい。
 </para>
 </warning>
 
@@ -495,11 +499,37 @@ makefml config は実装途中で、まだイマイチです。ごめんなさい。
 
 <para>
 /usr/local/etc/fml/site_default_config.cf
-は、このホストで動く fml すべてに影響を与えます。
+は、このホストで動く &fml8; すべてに影響を与えます。
 <footnote>
 <para>
-これは &fml4; の site_force.ph に相当するものです。
+これは &fml4; の site_init.ph に相当するものです。
 </para>
+
+<para>
+&fml4; では次のように設定ファイルを読み込んでいきます。
+<screen>
+InitConfig {
+   SetDefaults { ... };
+   LoadConfig {
+      include default_config.ph;
+      include site_init.ph;
+      include config.ph;
+      include site_force.ph;
+      include sitedef.ph;
+   }
+}
+</screen>
+&fml8; では
+<screen>
+/usr/local/etc/fml/$fml_version/default_config.cf
+/usr/local/etc/fml/site_default_config.cf
+/usr/local/etc/fml/domains/$DOMAIN/default_config.cf
+/var/spool/ml/elena/config.cf
+</screen>
+のようになっています。
+site_force.ph がありませんが、困ってないので、今のところ作る予定なし。
+</para>
+
 </footnote>
 </para>
 
@@ -523,17 +553,24 @@ site_default_config.cf のフォーマットは、config.cf (後述)と同様で、
 <para>
 elena ＭＬの設定のカスタマイズは 
 /var/spool/ml/elena/config.cf
-を編集して下さい。
+を編集することで行ないます。
 <link linkend="internal.config.cf">
-フォーマットは postfix の設定ファイル
+config.cf のフォーマットは Postfix の設定ファイル
 </link>
-とかなり似ています(&fml4; の config.ph よりは cf にやや近いですが、フォー
-マットが違うことに変わりはない)。
-HOOK (perl script)を書く場合は、
-(perl script ファイルのように) =cut より後に書いて下さい。
+とかなり似ています
+(&fml4; の config.ph よりは &fml4; の cf にやや近いですが、
+フォーマットが違うことに変わりはない)。
+</para>
+
+<para>
+&fml8; で HOOK (perl script)を書く場合は、
+(perl script ファイルのように) 
+/var/spool/ml/elena/config.cf 
+ファイルの =cut 行以下に書いて下さい。
 </para>
 
 <para>
+=cut 行より上には設定( 変数 = 値 )を書いて下さい。
 適宜、必要な項目だけを追加して下さい。
 指定しない場合はデフォルト値が使われます。
 デフォルト値はインストールしたバージョンに依存しており、
diff --git a/fml/doc/ja/tutorial/overview/ml.sgml b/fml/doc/ja/tutorial/overview/ml.sgml
index 980de444..c3f549f4 100644
--- a/fml/doc/ja/tutorial/overview/ml.sgml
+++ b/fml/doc/ja/tutorial/overview/ml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: ml.sgml,v 1.3 2003/04/15 14:51:43 fukachan Exp $
+   $FML: ml.sgml,v 1.4 2004/10/06 09:07:41 fukachan Exp $
 -->
 
 
@@ -33,6 +33,34 @@ Subject: あそぼうよ
 </screen>
 </para>
 
+<para>
+Unix でおなじみの : で区切る形式は、
+インターネットのさまざまな規格でも使われています。 
+このメールで使われている 822 形式と呼ばれる「フィールド:値」が、
+その代表例です。
+意味は英語の文字どおりで、
+フィールド From (送信者) の値が送信者のメールアドレスといった具合になります。
+</para>
+
+<para>
+メールの規格は RFC822 で定義されたので通称 822 形式で意味が通じます。
+<footnote>
+<para>
+規格自体は、どんどん新しくなるので、2822 さらに 5322 などと呼ばれるよ
+うになるのが正しいでしょう。
+それでも、最初の規格名は、いつまでも通じるでしょう。
+</para>
+
+<para>
+なお、Internet Standard として公式には今でも 822 が正式規格で、
+実質的には 2822 が規格書です。
+5322 は DRAFT STANDARD で、さらに一段階格下のステータスです。
+たぶん、一段階上がる時のタイミングで 
+X822 になる番号を確保してリリースされるのではないかと？
+</para>
+</footnote>
+</para>
+
 </sect1>
 
 
@@ -43,16 +71,34 @@ Subject: あそぼうよ
 	</title>
 
 <para>
-メーリングリスト(以下ＭＬ)とは、巨大な文通の仕組みのようなものです。
+メーリングリスト(以下ＭＬ)とは「巨大な文通の仕組み」のようなものです。
+「配送が簡単な会誌製造機」という説明のほうが分かりやすいでしょうか？
+</para>
+
+<para>
+もっとも会誌の配送を紙媒体で行なおうとすると、
+誰かが書いた会誌を大量にコピーし、
+それを封筒につめ、切手を貼り、郵便で送る。
+お金もかかるし、手間も膨大な話です。
+</para>
+
+<para>
+一方、電子メールなら低コストで大量にコピー
+<footnote>
+<para>
+もっとも、これがたたって SPAM 屋が大量に発生しているわけですが…
+</para>
+</footnote>
+できます。
+仮想のある人(ＭＬのアドレス)にメール(会誌の原稿)を送ると、
+「文通友の会」のメンバー全員にそのメールのコピー(会誌)を配ります。
 </para>
 
 <para>
-ただ、電子メールはいくらでもコピーできるので、
-仮想のある人(ＭＬのアドレス)にメールを送ると、
-文通友の会のメンバー全員にそのメールのコピーを配ります。
 これがＭＬの仕組みです。
 </para>
 
+
 <sect2 id="overview.mldriver">
 	<title>
 	ＭＬドライバのモデル
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
index eab59031..9a067458 100644
--- a/fml/doc/ja/tutorial/preface.sgml
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: preface.sgml,v 1.26 2005/11/19 04:17:10 fukachan Exp $
+   $FML: preface.sgml,v 1.27 2008/08/16 00:26:18 fukachan Exp $
 -->
 
 
@@ -10,7 +10,7 @@
 
 
 <para>
-「１０年たったらソフトウエアは一から書き直せ」
+「十年たったらソフトウエアは一から書き直せ」
 そういう悟りの境地が大事だと思う今日この頃です(一撃でまとめすぎ)。
 </para>
 
@@ -22,23 +22,27 @@
 
 
 <para>
-現状の &fml8; は運用ベースの実証実験の段階です。
+現状の &fml8; は、
+(&fml4; 完全互換ではないため
+バージョン番号こそ 7.98.x という名前で
+「かぎりなく Release Candidate なベータ版」というあつかいですが)
+実際には何年にも渡って運用し続けている安定版です。
 </para>
 
 <para>
-ＭＬとしての基本的な機能は全て実装されています。
+メーリングリスト(ＭＬ)・ドライバとしての基本機能は全て実装されています。
 </para>
 
 <para>
-CUI は、ほぼ全部実装済みですが、
-config コマンドの細かいメニュー画面がありません。
+コマンドラインインターフェイス(CUI)は設定メニュー画面をのぞき、
+すべて実装済です。
 ＭＬごとに細かい設定変更をしたい場合はファイルの編集が必要ですが、
-それ以外はツール類を含めて &fml4; と同様に使えるはずです。
+普通に運用するのであれば、&fml4; と同様に使えるはずです。
 </para>
 
 <para>
-GUI も基本機能は実装済みですが、
-メニュー画面とか、まだいろいろ作らないと行けません。
+GUI も基本機能は実装済みです。
+こちらも設定メニュー画面が未実装で、まだいろいろ作りこまないといけません。
 </para>
 
 <para>
@@ -50,12 +54,12 @@ GUI も基本機能は実装済みですが、
 </para>
 
 <para>
-&fml4; の細かい機能の中には &fml8; で捨てたものがありますが、
-たいていの用途では &fml8; で大丈夫なはずです。
+&fml4; の細かい機能の中には &fml8; で非採用となったものもありますが、
+たいていの用途は &fml8; でカバーできるはずです。
 </para>
 
 <para>
-なお、現在の &fml8; で動く機能そして TODO リストは
+現在 &fml8; で動く機能、そして最近の TODO リストは
 <ulink url="http://www.fml.org/software/fml8/fml/doc/ja/todo/STATUS.txt">
 http://www.fml.org/software/fml8/fml/doc/ja/todo/STATUS.txt
 </ulink>
@@ -72,32 +76,83 @@ http://www.fml.org/software/fml8/fml/doc/ja/todo/STATUS.txt
 	</title>
 
 <para>
-&fml8; プロジェクトは &fml4; を『1 から書き直す次世代 fml プロジェクト』
-です。これは &fml4; までに至る約 10 年の経験を再実装する試みといえます。
+&fml8; プロジェクトは
+&fml4; を「1 から書き直す次世代 fml プロジェクト」です。
 &fml4; と &fml8; の関係は
-sendmail と postfix のような関係と思って下さい。
+sendmail と postfix のような関係というアナロジーが適切です。
 </para>
 
 <para>
-次世代 fml は、現代的観点から &fml4; の”機能”を再構想/再実装する試み
-ともいえます。これはデザインを一から考え直すことに加え、機能や変数の整
-理整頓も含んでいます。
+&fml8; は &fml4; までに至る約 10 年の経験ふまえ、
+現代的観点から &fml4; の”機能”を再構想/再実装する試みです。
 </para>
 
 <para>
-例えば &fml4; を使っていて問題になるのは「特定のホストで、ディスクの上
-にメンバーファイルを書く」というデザインです。これは最初のバージョンか
-ら継承され続けている基本構造です。しかしながら、RDBMS との連携や冗長化
-構成を考えると問題があります。「NFS の時はどうする？」「トラブルチケッ
-トシステムと連動したい場合は？」「SQL サーバとも連動したいですね？」
+(1)「作者自身」が
+(2)「同じもの(もしくは非常に互換性の高いもの)を一から書き直す」
+試みは初めてなのではないかと思います。
+条件(1)(2)の片方だけであれば、今までもいろいろとありました。
+その一番すぐれた事例が Postfix でしょう。
+</para>
+
+<para>
+&fml8; には、
+デザインを一から考え直すことに加え、
+&fml4; の機能や変数群の整理整頓といった要素もあります。
+</para>
+
+<para>
+たとえば &fml4; を使っていて気になる点の一つは
+「特定のホストで、ディスクの上にメンバーファイルを書く」
+というデザインです。
+これは &fml4; の最初から継承されてきている基本構造です。
+<footnote>
+
+<para>
+&fml4; 設計当時のターゲットマシンは 4.3 BSD (SONY NeWS)で、
+CPU は MIPS3000 が最先端だった時代でした。
+</para>
+
+<para>
+IBM 互換 PC (i386 〜 i486)が普及してきたのは、もう少し後です。
+初代の ftp.fml.org (当時は phys.titech.ac.jp ドメイン)が i486 でした。
+</para>
+
+<para>
+ワークステーションが 200 万、IBM PCが 40 万くらいした時代の話です。
+</para>
+
+<para>
+もちろん当時もホームディレクトリで NFS は使っていましたが、
+「ＭＬサーバを動かすならデータの保存対象はローカルディスクのみ」
+という判断をしました。
+まして LDAP や RDBMS なんて必要がなかったし、
+分散して動かすほどマシンが手元にありません(苦笑)。
+</para>
+
+<para>
+ただ、初期段階で想定外のものに対して拡張対応をするのは、
+やはり、いろいろな無理があるものです ← ここ 20 年の含蓄を含んだセリフ。
+</para>
+
+</footnote>
+</para>
+
+<para>
+しかしながら、RDBMS との連携や冗長化構成を考えると問題があります。
+「NFS の時はどうする？」
+「トラブルチケットシステムと連動したい場合は？」
+「SQL サーバとも連動したいですね？」
 などなど…
 </para>
 
 <para>
 また、構造論ではなく単に自分で欲しい機能があります。fml 自体が簡易版 
-bug tracking system を提供して欲しいし、bug tracking system もサーチエ
-ンジンもできるだけメールと連動していろいろして欲しい。cvs ログとも連動
-して欲しい。SPAM は隔離しろ。
+bug tracking system を提供して欲しいし、
+bug tracking system 
+もサーチエンジンもできるだけメールと連動していろいろして欲しい。
+cvs ログとも連動して欲しい。
+SPAM は隔離しろ。
 </para>
 
 <para>
@@ -130,8 +185,10 @@ bug tracking system を提供して欲しいし、bug tracking system もサーチエ
 
     </itemizedlist>
 
-これらについての意見を募集したいと思っています。ですが、漠然と議論して
-もしょうがないので、議論の叩き台として動くものを作りつつあります。
+これらについての意見を募集したいと思いますが、
+漠然と議論してもしょうがないので、
+議論の叩き台として動くものを作って動かしています。
+それが &fml8; です。
 </para>
 
 <para>
@@ -155,8 +212,7 @@ fml 1.2 相当の最低限の機能
 + 自動 HTML 化機構
 </screen>
 が動くことになるでしょう
-(というか、これらの機能はすでに動いていて３年以上、複数の環境で動作確
-認がされています)。
+(これらの機能はすでに数年来動作し続け、複数の環境で動作確認がされています)。
 </para>
 
 </sect1>
@@ -202,8 +258,8 @@ current という位置付けになります。4.0 の bug fix は 4.0.x (4.0.1 4.0.2
 <para>
 言い替えると、
 4.0 系列の bug fix は 4.0 で行ないますが、
-新機能は、&fml8; で開発したものをモジュール単位で 4.0 へ輸入していく
-形をとります。
+新機能は、
+&fml8; で開発したものをモジュール単位で 4.0 へ輸入していく形をとります。
 </para>
 
 
@@ -225,7 +281,8 @@ current という位置付けになります。4.0 の bug fix は 4.0.x (4.0.1 4.0.2
 
 fml-devel MLへの自動登録は fml-devel-ctl@ffs.fml.org へ
 subscribe の後に自分の名前をローマ字で続けたフレーズをメールの"本文"
-(注意: メールの本文)に書いて送って下さい。例えば次のようになります。
+(注意: メールの本文)に書いて送って下さい。
+たとえば次のようになります。
 
 <screen>
 To: fml-devel-ctl@ffs.fml.org
diff --git a/fml/doc/ja/tutorial/setup/apache.sgml b/fml/doc/ja/tutorial/setup/apache.sgml
index 58ee7c97..a1f62e56 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.3 2004/10/06 09:07:42 fukachan Exp $
+   $FML: apache.sgml,v 1.4 2005/06/25 15:11:36 fukachan Exp $
 -->
 
 
@@ -22,23 +22,34 @@ fml8 CGI の内部構造については
 </warning>
 
 
+<!-- TODO: suexec on apache 2.2 -->
 <sect1 id="setup.apache.suexec">
 	<title>
 	apache で suexec を使う
 	</title>
 
 <para>
-suexec 利用可能な apache を作る必要があります。 
+suexec 機能を利用可能な apache を作る必要があります。 
 configure を実行する際に、
 <screen>
 (apache 1.x の場合)
-configure --enable-suexec --suexec-caller=www
+# ./configure --enable-suexec --suexec-caller=www (...その他のオプション...)
 </screen>
 などとします。
-ここでは suexec を呼びだすことが可能なユーザが www です。
-このユーザには、この用途専用のものを用意して下さい。
 </para>
 
+<important>
+<para>
+この例では suexec を呼び出すことが可能なユーザが www です。
+CGI ユーザには、CGI 用途専用のユーザを用意して下さい。
+</para>
+
+<para>
+suexec を呼び出すことが可能なユーザが www です。
+CGI ユーザには、CGI 用途専用のユーザを用意して下さい。
+</para>
+</important>
+
 <para>
 インストール後、~ユーザ/cgi-bin/ を許すように httpd.conf を
 変更する必要があります。
diff --git a/fml/doc/ja/tutorial/setup/cgi.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml
index 7ebc9cb0..124c63d4 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.10 2008/08/19 07:11:02 fukachan Exp $
+   $FML: cgi.sgml,v 1.11 2008/09/28 03:31:00 fukachan Exp $
 -->
 
 
@@ -25,10 +25,17 @@ CGI の内部構造については
 apache で suexec を使う
 </link>
 ことを前提としています。
-つまり http://mail.example.org/~fml/cgi-bin/.../config.cgi などといった
-URL を使うつもりでいます。
+つまり
+<screen> 
+http://mail.example.org/~fml/cgi-bin/fml/DOMAIN/admin/config.cgi 
+http://mail.example.org/~fml/cgi-bin/fml/DOMAIN/ml-admin/ML/config.cgi 
+</screen> 
+といった URL を使う前提です。
 </para>
 
+</warning>
+
+
 <para>
 ＭＬごとの管理用 CGI、
 ドメイン全体を管理する CGI
@@ -40,52 +47,71 @@ URL を使うつもりでいます。
 <para>
 管理用 CGI インターフェイスでは、ユーザの追加、削除、メンバーリストや
 ログの閲覧などが可能ですが、CGI からの設定変更インターフェイス(
-config.cf の編集機能)が中途半端です。
+設定ファイル config.cf の編集機能)が中途半端です。
 </para>
 
-<!--
 <para>
-なお、CGI から設定変更を行なう場合でも、メールサーバとして Postfix や 
-qmail を使っているなら、CGI 用の特別な「メールサーバの設定変更」は不要
-です。
+「CGI から操作可能」なコマンドは、すべて CUI と同じ効果を持ちます。
+たとえば、ＭＬの作成や削除もコマンドラインと全く同一ですので、
+CGI 用の特別な作業は不要です。
 </para>
--->
 
-</warning>
 
 
 <sect1 id="setupcgi.install">
 	<title>
-	いつでも makefml newml は CGI スクリプトを作ります
+	makefml newml は、つねに CGI スクリプトを作成
 	</title>
 
 <para>
-makefml newml を実行すると、
-CGI スクリプトが ~fml/public_html/ 以下に作成されます。
+makefml newml ML (fml ML newml)を実行すると、
+~fml/public_html/ 以下に CGI スクリプトが作成されます。
+</para>
+
+
+<warning>
+<para>
+つねに CGI スクリプトは作成されます。
+一方、
+apache のデフォルト設定では ~fml/ 以下は見えません。
+</para>
+
+<para>
+この(制限された)意味において
+「&fml8; デフォルトでは CGI が無効」と言いっています。
 </para>
 
+</warning>
+
+
 <para>
 この CGI は前述のように３種類あります。
 管理用の二種類には
-ドメイン全体を管理する CGI と、
-それぞれのＭＬを管理する CGI があり、それぞれの次のパスに作成されます。
+「ドメイン全体を管理する CGI」と、
+「それぞれのＭＬを管理するＭＬ専用の CGI」があり、
+それぞれ、次のパスに作成されます。
 <screen>
-そのドメインのＭＬ全部の管理者用
+そのドメイン全体の管理者用 (そのドメインすべてのＭＬを管理可能)
 ~fml/public_html/cgi-bin/fml/ドメイン/admin/config.cgi
 
-ＭＬごとの管理者用
+ＭＬごとの管理者用 (そのＭＬのみを管理可能)
 ~fml/public_html/cgi-bin/fml/ドメイン/ml-admin/ＭＬ名/config.cgi
 </screen>
-一般ユーザ向けの CGI は、
-WWW サーバの設定で ACL が書きやすいように、
-わざと別のパスに作成しています。
+一方、一般ユーザ向けの CGI (ＭＬの入会・退会申請メニュー用)は、
+WWW サーバの設定でフィルタが書きやすいように、
+わざと異なるパスに作成しています。
 <screen>
 ~fml/public_html/cgi-bin/anonymous/ドメイン/ＭＬ名/submit.cgi
 </screen>
+必要に応じ、WWW サーバの設定で
+「 ~fml/public_html/cgi-bin/fml/ 」
+と
+「 ~fml/public_html/cgi-bin/anonymous/ 」
+で異なるアクセス制御を行なって下さい。
 </para>
 
 <para>
-例えば、elena@fml.org ＭＬを作成すると次の３つが作成されます。
+たとえば、elena@fml.org ＭＬを作成すると次の３つが作成されます。
 <screen>
 ○ fml.org の全ＭＬを管理する CGI スクリプト
 
@@ -124,7 +150,8 @@ WWW サーバの認証システムにおんぶにだっこです。
 </para>
 
 <para>
-もう少し、設定支援コマンドがあるべきですね。
+それはいいとしても、もう少し、
+&fml8; での WWW サーバ設定支援ツールがあるべきでしょうね。
 </para>
 
 </sect1>
@@ -136,7 +163,8 @@ WWW サーバの認証システムにおんぶにだっこです。
 	</title>
 
 <para>
-デフォルトでは、とりあえず潰してありますので、適切に設定して下さい。
+デフォルトでは、とりあえず潰してあります(認証エラーになる)ので、
+適切に変更して下さい。
 </para>
 
 <para>
@@ -152,7 +180,7 @@ http://lists.fml.org/~fml/cgi-bin/fml/fml.org/.htaccess
 
 <para>
 デフォルトの .htaccess は次のような無意味:)なものになっていて、
-アクセスできません。
+アクセスできません(エラーになります)。
 <footnote>
 <para>
 さらに、デフォルトの apache では ~fml/ へのアクセスは出来ないはずなの
@@ -179,11 +207,13 @@ require valid-user
 
 <warning>
 <para>
-(当たり前ですが)この .htaccess ファイルを消すと、誰でもアクセスできる
-ようになります。デバッグする場合は便利ですが、そういう裏技は使わないよ
-うにしましょう;-)また、そういうデバッグなんて時に限って、そのまま再設
-定し忘れたりするものなので、しない方が良いです。きちんと .htaccess を
-設定しましょう。
+(当たり前ですが)この .htaccess ファイルを消すと、
+誰でもアクセスできるようになります。
+デバッグする場合は便利ですが、そういう裏技は使わないようにしましょう;-)
+また、そういう「デバッグだけだから、ちょっとだけ…」という時にかぎって、
+そのまま再設定し忘れたりするものなので、
+そういう流儀に慣れないようにしてください。
+きちんと .htaccess を設定しましょう。
 </para>
 </warning>
 
@@ -196,18 +226,18 @@ require valid-user
 	</title>
 
 <para>
-この CGI は
-「makefml を実行できる権限を与えても良いけれど、
-でも、UNIX のコマンドラインを使うのがちょっと辛い」
-という人を想定し、あるドメイン全体を操作できる権限を与えています。
+この CGI は、あるドメイン全体を操作できる権限を与えています。
+「ＭＬを管理する権限を与えても良いけれど、
+でも Unix のコマンドラインを使うのがちょっとつらい」
+という人を想定したものです。
 よって、ＭＬの作成などができるわけですが、
-makefml のすべての機能が使えるわけでもありません。 
+makefml のすべての機能が使えるわけでもありません。
 </para>
 
 <para>
-画面を見るとわかる通り、
-CGI で可能な項目は makefml のサブセットとなっています。
-使用可能なコマンドは最初の画面にヘルプとして表示されているものだけです。
+CGI の画面を見るとわかる通り、
+CGI で可能な項目は makefml の部分集合となっています。
+利用可能なコマンドは最初の画面にヘルプとして表示されているものだけです。
 <screen>
 例: CGI トップ画面
 
@@ -233,7 +263,7 @@ options Language:    list        アドレスリストを見る
 
 <para>
 なお、画面の左下もしくは右にヘルプメッセージが表示されるので
-それを参考にして下さい。
+操作の際には、それを参考にして下さい。
 もちろんコマンドごとにメッセージは異なります:)
 </para>
 
@@ -257,7 +287,7 @@ ML 名を選択する必要はありません:)
 </para>
 
 <para>
-中央に、ＭＬ名の入力を促す画面が現れるので、
+中央に、ＭＬ名の入力をうながす画面が現れるので、
 作成するＭＬ名を入力し、中央の submit ボタンを押して下さい。
 </para>
 
@@ -279,7 +309,7 @@ submit ボタンを押して下さい。
 </para>
 
 <para>
-中央に、アドレスの入力を促す画面が現れるので、
+中央に、アドレスの入力をうながす画面が現れるので、
 登録したいアドレスを入力し、
 中央の submit ボタンを押して下さい。
 </para>
@@ -327,7 +357,7 @@ TODO: cookie で設定を覚えておくようにしようと考えています。
 
 <para>
 &fml8; を使ったＭＬへの入会/退会(subscribe/unsubscribe)は、
-元々
+もともと
 <link linkend="fml.command.bymail">
 メールベースのシステム
 </link>
@@ -335,15 +365,19 @@ TODO: cookie で設定を覚えておくようにしようと考えています。
 </para>
 
 <para>
-このコマンドメールによる入会/退会(subscribe/unsubscribe)の最初のフェイ
-ズだけは CGI でも出来るようにしました。
+このコマンドメールによる入会/退会(subscribe/unsubscribe)
+の最初のフェイズだけは CGI でも出来るようにしました。
+</para>
+
+<para>
 CGI だけで入会/退会が出来るとセキュリティ面でもよろしくないので、
 <screen>
-(1) 最初は CGI から申請、
+(1) 最初だけは CGI から申請、
 (2) メールで confirmation を送る、
 (3) メールで confirmation が返ってきたら OK
 </screen>
-としています。
+としています
+(もちろん、これ以上 HTTP をつかった高度なものにする予定もありません)。
 </para>
 
 <para>
@@ -354,28 +388,29 @@ CGI だけで入会/退会が出来るとセキュリティ面でもよろしくないので、
 <para>
 なお、この CGI には、SPAM よけの”おまじない”として、メールアドレスを
 魔法の文字列の２つをセットで入力してもらうようにしてあります。
-「ゆがんだ文字列を認識できるのは機械ではなく人間に違いない」(image
-verification)です。
+「ゆがんだ文字列を認識できるのは機械ではなく人間に違いない」
+(image verification)です。
 </para>
 
 <para>
 ま、気休めですけどね。
 どうせ、このあとメールによる confirmation もあるので、
-あまり気にしないでよいでしょう。 
+このおまじないの精度は気にしないでください。
 </para>
 
 <para>
-しょせん CGI などメールによる confirmation システムの wrapper にすぎな
-いという位置付けです。単体では動作させません。
-そのため、一般ユーザ用の CGI は、すべてのこの image verification で申
-請を出してもらうようにして、パスワード認証などといった面倒なシステムは
-廃しています。
+しょせん CGI など、
+メールによる confirmation システムの wrapper にすぎないという位置付けです。
+CGI 単体では動作させません。
+そのため、一般ユーザ用の CGI は、
+すべてのこの image verification で申請を出してもらうようにして、
+パスワード認証などといった面倒なシステムは廃しています。
 </para>
 
 
 <sect2>
 	<title>
-	議論: 一般ユーザ用にパスワード認証させるのってどうよ？
+	議論: 一般ユーザ用パスワード認証は、どうなのか？
 	</title>
 
 <para>
@@ -393,13 +428,13 @@ verification)です。
 また、そういったシステムでは、パスワードを忘れた場合に再送を依頼すると、
 メールで平文パスワードが送られてきたりする始末です。
 分かりにくいパスワードといえど、
-大抵個人的な情報を元にした連想だったりするので、
-そういったパスワードが平文でやりとりされるのは単体で危険といえるばかり
-でなく、それ以外のシステムへの危険性を増します。
+たいてい個人情報を元にした連想だったりします。
+パスワードが平文でやりとりされるのは単体で危険といえるばかりでなく、
+それ以外のシステムへの危険性を増します。
 </para>
 
 <para>
-毎日使うようなシステム
+毎日つかうようなシステム
 <footnote>
 <para>
 もちろんパスワード認証システムは、
@@ -411,7 +446,6 @@ verification)です。
 
 </sect2>
 
-
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml
index 9844a25a..ab473970 100644
--- a/fml/doc/ja/tutorial/setup/config.cf.sgml
+++ b/fml/doc/ja/tutorial/setup/config.cf.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: config.cf.sgml,v 1.6 2005/06/25 15:11:37 fukachan Exp $
+   $FML: config.cf.sgml,v 1.7 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -12,9 +12,11 @@
 makefml は、
 makefml newml を実行した際に、
 そのＭＬの config.cf などの設定ファイル群を一式を作り、
-さらに MTA が fml を起動する際に使う include 類( postfix 用)および
-~fml/.qmail-* ( qmail 用 )
-などの必要な設定ファイル一式を用意します。
+さらに MTA が fml を起動する際に使う設定ファイル一式を用意します。
+MTA 用の設定ファイルとは、
+Postfix/Sendmail 用の include ファイル群および
+qmail 用の ~fml/.qmail-* 
+などの必要な設定ファイル一式です。
 <screen>
 % su fml
 % makefml newml elena
@@ -28,17 +30,19 @@ config.cf include include-ctl include-error
 <warning>
 
 <para>
-現状、設定支援ツールが未完成なので、ＭＬのカスタマイズは config.cf を
-エディタで編集して下さい。
+現状、
+メニュー方式の設定支援ツールが未完成なので、
+ＭＬのカスタマイズは config.cf をエディタで編集して下さい。
 </para>
 
 </warning>
 
 <para>
-makefml newml が作る config.cf には、ほとんど何も定義されていません(つ
-まりデフォルト値を使うことになっています)。
+makefml newml が作る config.cf には、ほとんど何も定義されていません
+(つまりデフォルト値を使うことになっています)。
 config.cf の先頭の ml_domain と ml_name もコメントになっていますが、
-それらはコマンドの引数から自動的に決定されるのでコメントで OK です。
+それらはコマンドの引数から自動的に決定されるものです
+(よって、コメントのままで OK)。
 </para>
 
 <para>
@@ -53,13 +57,8 @@ config.cf の先頭の ml_domain と ml_name もコメントになっていますが、
 などとなっています。MTA から起動された 
 /usr/local/libexec/fml/distribute
 コマンドなどが、このコマンド引数の elena@fml.org の部分から
-ml_domain と ml_name を自動的に設定します。
-そのため config.cf ではコメントのままで問題ありません。
-</para>
-
-<para>
-include include-ctl aliases の書き方は &fml4; と同様です。
-コマンドの PATH がちょっと違いますが、aliases の設定の仕方は一緒です。
+ml_domain と ml_name を自動的に設定します
+(そのため config.cf ではコメントのままで問題ありません)。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
index d6b7a288..2dc4b670 100644
--- a/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
+++ b/fml/doc/ja/tutorial/setup/merge.fml4to8.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: merge.fml4to8.sgml,v 1.6 2005/06/25 15:11:37 fukachan Exp $
+   $FML: merge.fml4to8.sgml,v 1.7 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -10,9 +10,10 @@
 
 <para>
 2004/03: &fml4; の $DIR ($ml_home_dirにあたるもの)、たとえば 
-/var/spool/ml/elena 以下のファイル群を &fml8; 形式の構成へ自動変換する
-コマンドを実装しました。ただ、まだ設定ファイルの翻訳機能は予備的なもの
-で、順次、改良されていく予定です。
+/var/spool/ml/elena 以下のファイル群を 
+&fml8; 形式の構成へ自動変換するコマンドを実装しました。
+ただ、まだ設定ファイルの翻訳機能は予備的なもので、
+順次、改良されていく予定です。
 </para>
 
 <para>
@@ -21,8 +22,8 @@
 &fml4; の fml.pl を &fml8; の fml.pl と入れ換え可能
 </link>
 としました。つまり、&fml8; による &fml4; の直接エミュレーションです。
-これは &fml4; の fml.pl を &fml8; の fml.pl に入れ換えるだけで 4 から 
-8 へのアップグレードを可能にしようとするものです。
+これは &fml4; の fml.pl を &fml8; の fml.pl に入れ換えるだけで 
+&fml4; から &fml8; へのアップグレードを可能にしようとするものです。
 </para>
 
 
@@ -32,26 +33,28 @@
 	</title>
 
 <para>
-要するに &fml4; から &fml8; への移行ということですが、
+ようするに &fml4; から &fml8; への移行ということですが、
 「&fml4; の実行ファイルを &fml8; で上書きすれば、そのまま動く」
 というわけではありません。
 </para>
 
 <para>
-今の &fml8; では、それに近いことも出来ますが、その際にも、設定ファイル
-の自動変換などバックグラウンドで色々な処理が行なわれています。
+今の &fml8; では、それに近いことも出来ますが、その際にも、
+設定ファイルの自動変換など、
+バックグラウンドでは、
+さまざまな処理が行なわれています。
 </para>
 
 <para>
 そもそも 4 を 8 で上書きしてしまうと、一斉に移行を強制することになるし、
-失敗した時のエラーリカバリが大変です。やはり、少しずつ移行していきたい
-でしょう。また、少しずつ移行する場合にも、出来れば、逆戻りができたほう
-がいいでしょう。
+失敗した時のエラーリカバリが大変です。
+やはり、少しずつ移行していきたいでしょう。
+また、少しずつ移行する場合にも、できれば逆戻りが可能であるべきです。
 </para>
 
 <para>
-そんなわけで、ＭＬ一つ一つを移行できるような仕組みにしておきたい。
-できれば、リカバリも出来ると良いとおもいます。
+そんなわけで、ＭＬを一つ一つ移行できるような仕組みにしておきたい。
+できれば、リカバリも出来ると良い、とおもうわけです。
 </para>
 
 <para>
@@ -59,7 +62,7 @@
 <screen>
 1. &fml8; をインストールする
 
-2. (postfix の場合) alias_maps に &fml8; の aliases を追加
+2. (Postfix の場合) alias_maps に &fml8; の aliases を追加
 
    例:
 	alias_maps	=	hash:/etc/mail/aliases
@@ -78,19 +81,19 @@
 
 <para>
 aliases や include の自動変換は、makefml mergeml コマンドが処理します。
-また、&fml4; の設定ファイルとメンバーリストを &fml8; 形式へ変換する作
-業も mergeml コマンドが行ないます。
+また、&fml4; の設定ファイルとメンバーリストを 
+&fml8; 形式へ変換する作業も mergeml コマンドが行ないます。
 </para>
 
 <para>
-さすがに、難しい設定がてんこ盛りの config.ph は無理ですが、簡単な
-config.ph であれば、&fml8; の config.cf へ全自動で変換できるつもりです。
+さすがに、難しい設定てんこ盛りの config.ph は無理ですが、
+簡単な config.ph であれば
+&fml8; の config.cf へ全自動で変換できているつもりです。
 </para>
 
 <para>
-なお、簡単な設定とは、Subject のタグと投稿制限の設定などの &fml4; の 
-makefml config (メニュー)で設定変更ができたレベルのものを想定していま
-す。
+なお、簡単な設定とは、Subject のタグと投稿制限の設定など &fml4; の 
+makefml config (メニュー)で設定変更ができたレベルのものを想定しています。
 </para>
 
 </sect1>
@@ -104,8 +107,8 @@ makefml config (メニュー)で設定変更ができたレベルのものを想定していま
 
 <para>
 2004/11: &fml4; の fml.pl を &fml8; の fml.pl と入れ換え可能としました。
-いわば、Postfix の /usr/sbin/sendmail (sendmail 互換コマンド)みたいな
-扱い方と考えればよいでしょう。
+いわば、Postfix の /usr/sbin/sendmail (sendmail 互換コマンド)
+同様の扱いと考えてください。
 </para>
 
 <para>
@@ -124,14 +127,15 @@ makefml config (メニュー)で設定変更ができたレベルのものを想定していま
 
 <para>
 正確には &fml4; の設定ファイルをそのまま使っているわけではありません。
-fml.pl (&fml8;) が起動された時に config.cf が見つからないと、ＭＬのホー
-ムディレクトリにある config.ph から config.cf を自動生成し、そのファイ
-ルを読み込んで &fml8; プロセスとして動作します。
+fml.pl (&fml8;) が起動された時に config.cf が見つからないと、
+ＭＬのホームディレクトリにある config.ph から config.cf を自動生成し、
+そのファイルを読み込んで &fml8; プロセスが動作しています。
 </para>
 
 <para>
-設定ファイルの自動変換が可能な範囲は限られていますが、&fml4; のメニュー
-で設定可能な(単純な)ものなら自動変換して何とかなるようになっています。
+設定ファイルの自動変換が可能な範囲は限られていますが、
+&fml4; のメニューで設定可能な(単純な)ものなら
+自動変換して何とかなるようになっています。
 </para>
 
 </sect1>
@@ -143,13 +147,13 @@ fml.pl (&fml8;) が起動された時に config.cf が見つからないと、ＭＬのホー
 	</title>
 
 <para>
-&fml8; は &fml4; を一旦忘れて、一から再設計、再コーディングされたソフ
-トウエアです。そのため、&fml4; と &fml8; では直接の対応関係がない機能
-や変数があります。
+&fml8; は &fml4; を一旦忘れて、
+一から再設計、再コーディングされたソフトウエアです。
+そのため、&fml4; と &fml8; では直接の対応関係がない機能や変数があります。
 </para>
 
 <para>
-また、対応関係があったとしても、一対一対応でないものも多いです。
+また、対応関係があったとしても、一対一対応ではないものも多いです。
 </para>
 
 <para>
@@ -163,13 +167,13 @@ fml.pl (&fml8;) が起動された時に config.cf が見つからないと、ＭＬのホー
 	</title>
 
 <para>
-「登録されたユーザからのみ投稿が可能」なのは &fml4; でも &fml8; でもデ
-フォルトです。もし誰でも投稿可能にしたいなら、&fml4; (の config.ph ファ
-イル)では
+「登録されたユーザからのみ投稿が可能」なのは 
+&fml4; でも &fml8; でもデフォルトの仕様です。
+「誰でも投稿可能」に変更したい場合、&fml4; (の config.ph ファイル)では
 <screen>
 $PERMIT_POST_FROM = "anyone";
 </screen>
-としますが、&fml8; (の config.cf)では
+としていましたが、&fml8; (の config.cf)では
 <screen>
 article_post_restrictions = reject_system_special_accounts
                             permit_anyone
@@ -193,7 +197,7 @@ article_post_restrictions = isolate_system_special_accounts
 
 <para>
 デフォルトでは「Subjectのタグがない」。
-これも &fml4; と &fml8; で同じです。
+これも &fml4; と &fml8; で同じ仕様です。
 そして、&fml4; での
 <screen>
 $SUBJECT_TAG_TYPE = '[:]';
@@ -228,9 +232,9 @@ article_subject_tag           = [$ml_name:%05d]
 </para>
 
 <para>
-&fml4; 以前および &fml4; 非推奨設定の状態では「フィルタは使わない」よ
-うになっています。しかし、&fml8; では「フィルタを使う」がデフォルトで
-す。
+&fml4; 以前および &fml4; 非推奨設定の状態では「フィルタは使わない」
+ようになっています。
+しかし、&fml8; では「フィルタを使う」がデフォルトです。
 </para>
 
 <para>
@@ -240,8 +244,9 @@ article_subject_tag           = [$ml_name:%05d]
 </para>
 
 <para>
-&fml4; と異なり、subscribe, chaddr, unsubscribe はconfirmation が必須
-となっています。現状、confirmation を抑制することは出来ません。
+&fml4; と異なり、
+subscribe, chaddr, unsubscribe は confirmation が必須となっています。
+現状、confirmation を抑制することは出来ません。
 </para>
 
 </sect2>
@@ -255,8 +260,8 @@ article_subject_tag           = [$ml_name:%05d]
 	</title>
 
 <para>
-以下の作業ですが、実際には変換するコマンド(makefml mergeml)が自動で頑
-張ります。
+変換するコマンド(makefml mergeml)が行なう作業を、以下で説明します。
+実際、手動で行なう必要はありません。
 </para>
 
 <para>
@@ -265,9 +270,10 @@ aliases と include ファイルについての説明をしておきます。
 </para>
 
 <para>
-まず、メールサーバに &fml4; から &fml8; を起動させるように変更しなくて
-はなりません。最終的に &fml8; が起動されることができれば、&fml4; の 
-config.ph を適宜解釈するとかする部分は、なんとかなるとはおもいます。
+まず、メールサーバに 
+&fml4; から &fml8; を起動させるように変更しなくてはなりません。
+途中経過はどうあれ、最終的に &fml8; を起動することができれば、
+&fml4; の config.ph を適宜解釈するといった作業はなんとかなるという考えです。
 </para>
 
 <para>
@@ -279,15 +285,16 @@ config.ph を適宜解釈するとかする部分は、なんとかなるとはおもいます。
 </para>
 
 <para>
-たとえば Postfix を使う場合、Postfix は aliases ファイルから include 
-ファイルを読むべきことを知り、include ファイルから &fml8; の起動の仕方
-を知ります。最終的に Postfix は /usr/local/libexec/fml/distribute コマ
-ンドを実行します。
+たとえば Postfix を使う場合、
+Postfix は aliases ファイルから include ファイルを読むべきことを知り、
+include ファイルから &fml8; の起動の仕方を知ります。
+最終的に Postfix は /usr/local/libexec/fml/distribute コマンドを実行します。
 </para>
 
 <para>
-起動された distribute コマンドは、config.cf を読み込み、config.cf から
-メンバーリストなどの場所を知り、さまざまな処理を行なうといった具合です。
+起動された distribute コマンドは config.cf を読み込み、
+config.cf から メンバーリストなどの場所を知り、
+さまざまな処理を行なうといった具合でブートストラップしていきまsす。
 </para>
 
 <para>
@@ -300,26 +307,25 @@ include ファイル
 </para>
 
 <para>
-そして、aliases ファイル（群）には同じＭＬの設定が重複していてはいけま
-せん。だから /etc/postfix/main.cf には次のように &fml4; と &fml8; の設
-定両方を書いてもよいのですが、
+そして、aliases ファイル（群）には同じＭＬの設定が重複していてはいけません。
+だから /etc/postfix/main.cf には、
+次のように &fml4; と &fml8; の設定両方を書いてもよいのですが、
 <screen>
 alias_maps	=	hash:/etc/mail/aliases
 			hash:/var/spool/ml/etc/aliases (fml4)
 			hash:/var/spool/ml/etc/mail/aliases (fml8)
 </screen>
-&fml4; と &fml8; の aliases ファイル間での重複はきちんと削除していかな
-いといけません。
+&fml4; と &fml8; の aliases ファイル間での重複は削除しておかないといけません。
 </para>
 
 <para>
 別の言い方をすると、
 <screen>
-MTA -> fml4のaliases -> fml4のinclude -> &fml4; (fml.pl)を起動する
+MTA -> &fml4; の aliases -> &fml4; の include -> &fml4; (fml.pl)を起動する
 </screen>
 となっている起動の順番を次のように変更するわけです。
 <screen>
-MTA -> fml8のaliases -> fml8のinclude -> &fml8; を起動する
+MTA -> &fml8; の aliases -> &fml8; の include -> &fml8; を起動する
 </screen>
 そのためには
 <screen>
diff --git a/fml/doc/ja/tutorial/setup/newml.recipes.sgml b/fml/doc/ja/tutorial/setup/newml.recipes.sgml
index 0883bc16..e80b6c81 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.4 2005/11/19 03:45:07 fukachan Exp $
+   $FML: newml.recipes.sgml,v 1.5 2008/09/28 03:31:00 fukachan Exp $
 -->
 
 
@@ -17,7 +17,7 @@
 
 <question>
 <para>
-newml 時に、aliasに使われるＭＬの管理者のメールアドレスを指定したい。
+newml 時にＭＬ管理者のメールアドレスを指定したい。
 </para>
 </question>
 
@@ -31,17 +31,18 @@ ${ml_name}-admin: 管理者のメールアドレス
 $newml_command_ml_admin_default_address 
 変数の値が入ります。
 
-デフォルトでは、どのＭＬでも /usr/local/etc/fml/main.cf で定義されてい
-る管理者のアドレス $fml_owner が使われます。
+デフォルトでは、
+どのＭＬでも /usr/local/etc/fml/main.cf 
+で定義されている管理者のアドレス $fml_owner が使われます。
 
-それ以外のものにしたい場合、site_default_config.cf で
+それ以外のアドレスに変更したい場合、site_default_config.cf で
 $newml_command_ml_admin_default_address 
 にメールアドレスを設定して下さい。
 <screen>
 $newml_command_ml_admin_default_address = メールアドレス
 </screen>
 
-また、$ml_name など、他の変数に依存した値も可です。
+また、$ml_name など、他の変数に依存した値も変更可です。
 <screen>
 $newml_command_ml_admin_default_address = $ml_name-owner@$ml_domain
 </screen>
@@ -57,19 +58,22 @@ $newml_command_ml_admin_default_address = $ml_name-owner@$ml_domain
 
 <question>
 <para>
-使わないMTA用のファイルの生成を止めたい。
+使わない MTA 用の見本生成を止めたい。
 </para>
 </question>
 
 <answer>
 <para>
-newml_command_mta_config_list に MTA のリストが定義されています。
-そこから、不要の MTA を抜いて下さい。
+newml_command_mta_config_list にインストールされる
+MTA のリストが定義されています。
+そこから不要の MTA を抜いて下さい。
 </para>
 
 <para>
 たとえば、qmail が不要であれば
 <screen>
+[/usr/local/etc/fml/site_default_config.cf]
+
 newml_command_mta_config_list -= qmail
 </screen>
 としてください。~/.qmail-* ファイルの生成がされなくなります。
@@ -90,16 +94,17 @@ newml_command_mta_config_list -= qmail
 <answer>
 	<para>
 	2008/09/09 以降の &fml8; は、newml 時に、
-	一般ユーザ向けに入会/退会用の CGI を作成しています。
+	一般ユーザ向け入会/退会用 CGI を作成しています。
 	その CGI の URL を案内に入れてみて下さい。
 	</para>
 
 	<para>
-	デフォルトでは CGI は使えないようになっているので、CGI の設定は
+	なお、
+	デフォルトでは CGI が使えないようになっているので、CGI の設定は
 	<link linkend="setupcgi">
 	<xref linkend="setupcgi">
 	</link>
-	の章を参照して下さい。
+	の章を参照して CGI を有効に下さい。
 	</para>
 
 </answer>
diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml
index be16698a..73495f80 100644
--- a/fml/doc/ja/tutorial/setup/newml.sgml
+++ b/fml/doc/ja/tutorial/setup/newml.sgml
@@ -1,13 +1,24 @@
 <!--
-   $FML: newml.sgml,v 1.9 2005/06/25 15:11:37 fukachan Exp $
+   $FML: newml.sgml,v 1.10 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
 <chapter id="setup.newml">
 	<title>
-	UNIX 上でＭＬを作成する
+	Unix 上でＭＬを作成する
 	</title>
 
+<para>
+コマンドラインの設定支援ツールには makefml と fml があります。
+makefml は &fml4; と同じシンタックスです。
+fml は引数の並び順が違うだけの同じコマンドです。
+<screen>
+makefml COMMAND ML      (optional arguments)
+fml     ML      COMMAND (optional arguments)
+</screen>
+以下では makefml を例にして説明します。
+</para>
+
 
 <sect1 id="setup.newml.default">
 	<title>
@@ -16,9 +27,12 @@
 
 <caution>
 <para>
-デフォルトドメインの場合、&fml4 と同じで構いません。
-バーチャルドメインを使う場合、ちょっと違います。
-バーチャルドメインについては
+デフォルトドメインの場合、&fml4 と同じです。
+</para>
+
+<para>
+バーチャルドメインを使う場合、&fml4; とはＭＬ名の扱いが異なります。
+バーチャルドメインの詳細については
 <link linkend="setup.newml.nondefault">
 <xref linkend="setup.newml.nondefault">
 </link>
@@ -34,8 +48,17 @@
 % makefml newml elena
    ... 処理の様子が出力される(略) ...
 </screen>
-デフォルトの /var/spool/ml 以外のパスを使いたい場合は
-makefml newdomain コマンドでパスを指定して下さい。
+</para>
+
+<para>
+デフォルトの /var/spool/ml 以外のパスを使いたい場合は、
+次のいづれかの方法を使って下さい。
+(1) インストール時の configure オプションで変更しておく、
+(2)
+<link linkend="virtualdomain">
+(バーチャルドメインの仕組みを援用して)
+</link>
+makefml newdomain コマンドで使いたいパスを指定する、
 <screen>
 % su root
 # makefml newdomain fml.org /var/spool/virtual/fml.org
@@ -44,12 +67,15 @@ makefml newdomain コマンドでパスを指定して下さい。
 % makefml newml elena
    ... 処理の様子が出力される(略) ...
 </screen>
-
+注意: 
+本ドキュメントの他の場所でも言及しているように、
+(運用するドメインは増えていくと仮定して)
+全ＭＬをバーチャルドメインで運用しておく方が素直だと考えてます。
 </para>
 
 
 <para>
-makefml newml は実行時、次のような処理を行ないます。
+「makefml newml elena」を実行すると次のような処理を行ないます。
 
 <itemizedlist>
 
@@ -61,27 +87,30 @@ makefml newml は実行時、次のような処理を行ないます。
 	include
 	include-ctl
 	</screen>
-	などを作る(適宜、elena やドメインの値を変換しながら)。
+	ファイルなどを作る(適宜、ＭＬ名やドメイン名を変換しながら)。
         </para>
    </listitem>
 
    <listitem>
         <para>
-	/var/spool/ml/etc/mail/aliases に elena の設定を仕込む。
+	/var/spool/ml/etc/mail/aliases に elena ＭＬの設定を仕込む。
 	postalias コマンドで
-	/var/spool/ml/etc/mail/aliases.db を再生成する。
+	/var/spool/ml/etc/mail/aliases.db を再生成する
+	(Postfix 用の設定)。
         </para>
    </listitem>
 
    <listitem>
         <para>
-	~fml/.qmail-* ファイル群を生成する。
+	~fml/.qmail-* ファイル群を生成する
+	(qmail 用の設定)。
         </para>
    </listitem>
 
    <listitem>
         <para>
-	procmailrc の見本を作る。
+	procmailrc の見本を作る
+	(これは見本を作るだけ)。
         </para>
    </listitem>
 
@@ -91,21 +120,23 @@ makefml newml は実行時、次のような処理を行ないます。
 	<screen>
 	~fml/public_html/fml/mlarchive/$domain/$ml/
 	</screen>
-	例えば elena@fml.org なら
+	たとえば elena@fml.org なら
 	<screen>
 	~fml/public_html/fml/mlarchive/fml.org/elena/
 	</screen>
 	を用意する。
 	デフォルトでは、
-	ここに HTML 化された記事が自動的に作られることになる。
+	ここに HTML 化された記事が自動的に作られる(
+	ただし、デフォルトでは apache の設定が無効のはずなので
+	インターネットには見えない)。
         </para>
    </listitem>
 
    <listitem>
         <para>
 	CGI インターフェイスを用意する。
-	ドメインで一番偉いインターフェイス(そのドメインのＭＬは全部操
-	作できる)が
+	ドメインで一番偉いインターフェイス
+	(そのドメインのＭＬは全部操作できる)が
 	<screen>
 	~fml/public_html/cgi-bin/fml/$domain/admin/config.cgi
 	</screen>
@@ -129,66 +160,86 @@ makefml newml は実行時、次のような処理を行ないます。
 
 <caution>
 <para>
-デフォルトドメインではない場合、&fml4 と異なります。
-注意点は、最初に newdomain コマンドを使うところとＭＬ名です。
+デフォルトドメインではない場合、&fml4; と大きく異なります。
+注意点は
+(1) 最初に newdomain コマンドを使う、
+(2) 操作時、ＭＬ名にはドメインをつける、
+の二点です。
 </para>
 </caution>
 
 <para>
 ＭＬ作成には makefml を使います。
 使い方は &fml4; と同様です。
-しかしながらＭＬ名にきちんとドメインまでつけるところが異なります。
+しかしながら「ＭＬ名にきちんとドメインまでつける」ところが異なります。
 注意して下さい。
 </para>
 
 <para>
+(新しいドメインを使いはじめる際)
 初回は newdomain コマンドによるドメイン定義も必要です。
 <screen>
+例: nuinui.net ドメインでのＭＬを使いはじめる時。
+
 % su root
 # makefml newdomain nuinui.net /var/spool/virtual/nuinui.net
 # exit
 % su fml
 % makefml newml elena@nuinui.net
 </screen>
-二回目以降の場合は
+二回目以降は
 <screen>
 % su fml
 % makefml newml rudo@nuinui.net
 </screen>
-だけでかまいません。
+だけでＭＬを作成できます。
 </para>
 
 <para>
-newdomainコマンドでは、ドメインと使う ml_home_prefix ディレクトリのペ
-アを指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファ
-イルの編集を代行します。上の例では ml_home_prefix ファイルに次の行が追
-加されます。
+newdomain コマンドでは、
+「ドメイン」と「使う ml_home_prefix ディレクトリ」のペアを指定します。
+上の例はハッシュで書けば
+<screen>
+{ nuinui.net => /var/spool/virtual/nuinui.net }
+</screen>
+を意味します。
+このコマンドは /usr/local/etc/fml/ml_home_prefix ファイルの編集を代行します。
+上の例では ml_home_prefix ファイルに次の行が追加されます。
 <screen>
 nuinui.net /var/spool/virtual/nuinui.net
 </screen>
-ちなみに、この対応関係を消す場合は rmdomain コマンドです。
+ちなみに、この対応関係を解消するコマンドは rmdomain です。
 </para>
 
 <para>
-newml コマンドは、引数のＭＬ名をドメイン名つきにする以外、デフォルトド
-メインの場合と操作方法は同じです。
+newml コマンドは、引数のＭＬ名を「ドメイン名つき」にする以外、
+デフォルトドメインの場合と操作方法は同じです。
 </para>
 
 <para>
-また、バーチャルドメインの場合、makefml newml は各 MTA ごとのバーチャ
-ルドメイン用設定見本を作ります。たとえば
+また、バーチャルドメインの場合、
+makefml newml は各 MTA ごとのバーチャルドメイン用設定見本を作ります。
+たとえば
 <screen>
-/var/spool/ml/etc/sendmail/virtusertable
-/var/spool/ml/etc/postfix/virtual
+/var/spool/nuinui.net/etc/sendmail/virtusertable
+/var/spool/nuinui.net/etc/postfix/virtual
+/var/spool/nuinui.net/etc/qmail/virtualdomains
+/var/spool/nuinui.net/etc/procmail/procmailrc
 </screen>
 が作られます。
-qmail 用の見本は作られません。
-な procmail は.procmailrcの見本がドメイン名つきなので別途バーチャル用
-という設定はありません。
+MTA の設定変更時の参考にして下さい。
+</para>
+
+<para>
+ちなみに procmail は、見本(
+/var/spool/nuinui.net/etc/procmail/procmailrc
+)自体がドメイン名つきなので、
+特別バーチャルドメイン用ではありません。
+いずれにせよ、見本に御利用下さい。
 </para>
 
 <para>
-詳しくは、
+技術的な詳細は、
 <link linkend="virtualdomain">
 バーチャルドメイン
 </link>
diff --git a/fml/doc/ja/tutorial/setup/postfix.sgml b/fml/doc/ja/tutorial/setup/postfix.sgml
index a68f6109..9d8d0957 100644
--- a/fml/doc/ja/tutorial/setup/postfix.sgml
+++ b/fml/doc/ja/tutorial/setup/postfix.sgml
@@ -1,21 +1,29 @@
 <!--
-   $FML: postfix.sgml,v 1.4 2004/04/07 11:07:12 fukachan Exp $
+   $FML: postfix.sgml,v 1.5 2005/06/25 15:11:37 fukachan Exp $
 -->
 
 <sect1 id="setup.postfix.aliases">
 	<title>
-	メールサーバの設定 (postfix)
+	メールサーバの設定 (Postfix)
 	</title>
 
+
 <important>
 <para>
-alias_maps が適切に設定されていれば、
-ＭＬ作成時にも特別な作業はありません。
-postfix の設定は自動的に更新されています。
+対象となるドメインを増やす際、
+ドメインごとに /etc/postfix/main.cf への設定追加作業が一回必要です。
+</para>
+
+<para>
+ドメインごとに一度 &fml8; の作成する見本に従って
+alias_maps (バーチャルドメインの場合は、alias_maps と virtual_maps 両方)
+を変更しておけば、
+ＭＬの作成・削除時に特別な作業はありません(
+&fml8; の設定ツールにより Postfix の設定は自動的に更新されます)。
 </para>
 
 <para>
-postfix の設定については
+Postfix の設定については
 <link linkend="install.postfix">
 <xref linkend="install.postfix">
 </link>
@@ -23,22 +31,27 @@ postfix の設定については
 </para>
 </important>
 
-
+<warning>
 <para>
-makefml はシステムの aliases (例: /etc/mail/aliases)を変更することはあ
-りません。各ドメインごとに用意されている alias ファイル 
-$ml_home_prefix/etc/mail/aliases へ必要な設定を追加することと、そのファ
-イルから aliases.db を再生成する作業を行ないます。
+&fml8; は OS の 
+aliases (例: /etc/mail/aliases)を変更することはありません。
 </para>
 
+<para>
+&fml8; の設定ツールは、各ドメインごとに用意されている alias ファイル 
+$ml_home_prefix/etc/mail/aliases へ必要な設定を追加し、
+そのファイルから aliases.db を再生成する作業を行ないます
+(ＭＬの作成・削除に必要な作業は設定ツールにおまかせです)。
+</para>
+</warning>
 
 <sect2>
 	<title>
-	補足: /var/spool/ml/etc/mail/aliases のフォーマット
+	補足情報: /var/spool/ml/etc/mail/aliases のフォーマット
 	</title>
 
 <para>
-fml が管理しているＭＬの aliases のエントリは
+&fml8; が管理しているＭＬの aliases のエントリは
 $ml_home_prefix/etc/mail/aliases
 に追加されます。
 <screen>
diff --git a/fml/doc/ja/tutorial/setup/procmail.sgml b/fml/doc/ja/tutorial/setup/procmail.sgml
index 9b8df9af..07c6f3b1 100644
--- a/fml/doc/ja/tutorial/setup/procmail.sgml
+++ b/fml/doc/ja/tutorial/setup/procmail.sgml
@@ -1,36 +1,36 @@
 <!--
-   $FML: procmail.sgml,v 1.5 2004/10/06 09:07:42 fukachan Exp $
+   $FML: procmail.sgml,v 1.6 2005/06/25 15:11:37 fukachan Exp $
 -->
 
 
 <sect1 id="setup.procmail">
 	<title>
-	自分のアカウントでＭＬを行ないたい
+	自分のアカウントでＭＬを行ないたい (Procmail の利用)
 	</title>
 
 <para>
 特定の(自分の)アカウントで、個人あてのメールもＭＬあてのメールも
 処理する必要のある場合があります。
-例えば、ISP のバーチャルドメインサービスの中には
+たとえば、ISP のバーチャルドメインサービスの中には
 そういったサービスがあります。
 </para>
 
 <para>
-このような場合には、メールのヘッダの To: や Cc: を見て、適切に fml を
-実行する必要があります。
+このような場合には、メールのヘッダの To: や Cc: を見て、
+どこ宛のＭＬなのかを判定し、適切に fml を実行する必要があります。
 </para>
 
 <para>
-こういった場合、&fml8; ではユーザが procmail などの振分ツールを使うだ
-ろうと期待しています:-)そのため、&fml8; に振り分けツールは用意されてい
-ません。OS のパッケージシステムなどを使って振り分けツールをインストー
-ルして下さい。
+こういった場合、
+&fml8; ではユーザが procmail などの振分ツールを使うだろうと期待しています:-)
+そのため、&fml8; に振り分けツールは用意されていません。
+OS のパッケージシステムなどを使って振り分けツールをインストールして下さい。
 </para>
 
 <para>
 なお makefml は newml の際に、~/.procmailrc の見本を 
-/var/spool/ml/etc/procmail/procmailrc に作るので、適宜利用してみて下さ
-い。
+/var/spool/ml/etc/procmail/procmailrc に作ります。
+利用してみて下さい。
 </para>
 
 
@@ -72,13 +72,14 @@ inbox/.
 <para>
 上の例で分かるようにドメイン名つきのルールが記述されているので、
 procmail の設定でバーチャルドメインか否かは関係ありません。
-よって、特別な設定はありません。
+この procmailrc の見本だけで十分です。
+これ以上特別な設定は必要ありません。
 </para>
 
 <para>
-もっとも、別途、バーチャルドメイン宛のメールをユーザ fml さんに転送す
-る設定が MTA に必要なのですが、それは ISP なりメールサーバの管理者が行
-なってくれる必要があります。
+もっとも、別途、バーチャルドメイン宛のメールを
+ユーザ fml さんに転送する設定が MTA に必要なのですが、
+それは ISP なりメールサーバの管理者が行なってくれる必要があります。
 </para>
 
 </sect2>
diff --git a/fml/doc/ja/tutorial/setup/qmail.sgml b/fml/doc/ja/tutorial/setup/qmail.sgml
index 86621826..6a2c1709 100644
--- a/fml/doc/ja/tutorial/setup/qmail.sgml
+++ b/fml/doc/ja/tutorial/setup/qmail.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: qmail.sgml,v 1.4 2005/06/25 15:11:37 fukachan Exp $
+   $FML: qmail.sgml,v 1.5 2006/05/17 13:13:19 fukachan Exp $
 -->
 
 
@@ -8,68 +8,38 @@
 	メールサーバの設定 (qmail)
 	</title>
 
-<para>
-makefml newml は次のような qmail 用の設定ファイルを作ります。
-<screen>
-~fml/.qmail-fml:org-elena
-~fml/.qmail-fml:org-elena-ctl
-</screen>
-よって
-<screen>
-/var/qmail/control/virtualdomains
-</screen>
-に、あらかじめ次のような設定を仕込んでおけば、
-makefml newml を実行するだけで自動的にＭＬが有効になります。
-<screen>
-fml.org:fml-fml.org
-</screen>
-</para>
-
 <warning>
 <para>
-この設定は、ＭＬ用に一つのドメインをまるまる使うことを前提としています。
+qmail の設定は、
+ＭＬ用に一つのドメインをまるまる使うことを前提としています。
 </para>
-</warning>
 
-<sect2>
-	<title>
-	バーチャルドメインの場合
-	</title>
+</warning>
 
 <para>
-makefml newml を実行するだけで自動的にＭＬが有効になるようにするには
-/var/qmail/control/virtualdomains
-に設定が必要です。しかしながら、このファイルは通常ユーザ fml さんには
-編集する権限がないので、ＭＬ管理者が設定を追加して下さい。
-<screen>
-ドメイン:fml-ドメイン
-
-例:
-
-[/var/qmail/control/virtualdomains]
-
-virtual.example.com:fml-virtual.example.com
-</screen>
-この追加は全てのドメイン分必要なことに注意して下さい。
+ＭＬ用のドメインを増やすたびに、追加設定が必要ですが、
+fml 固有の qmail 設定は不要です。
 </para>
 
 <para>
-また、そのドメインを /var/qmail/control/rcpthosts にも追加する必要があ
-ります。
-<screen>
-[/var/qmail/control/rcpthosts]
-
-virtual.example.com
-</screen>
+ＭＬ用にドメインを増やす際には
+/var/qmail/control/virtualdomains 
+と
+/var/qmail/control/rcpthosts
+に設定を追加し qmail-send に HUP シグナルを送る必要があります。
 </para>
 
 <para>
-この２つのファイルを編集したら qmail-send に HUP シグナルを送ってください。
-<screen>
-# kill -HUP qmail-sendのプロセスID
-</screen>
+ただし、初回に一回やればよいだけで、それ以降ＭＬの作成・削除は
+&fml8; の設定ツールが全自動で行ないます。おまかせでＯＫ。
 </para>
 
-</sect2>
+<para>
+詳細は、qmail におけるＭＬ作成方法
+<link linkend="install.qmail">
+<xref linkend="install.qmail">)
+</link>
+節を参照して下さい。
+</para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml
index 29f2f277..b0879ce7 100644
--- a/fml/doc/ja/tutorial/setup/test.sgml
+++ b/fml/doc/ja/tutorial/setup/test.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: test.sgml,v 1.9 2008/08/19 03:22:18 fukachan Exp $
+   $FML: test.sgml,v 1.10 2008/08/19 07:11:02 fukachan Exp $
 -->
 
 
@@ -29,7 +29,8 @@
 <warning>
 <para>
 newml の際のユーザ重複チェックを効かせるため、
-テストの前に Postfix の aliases をきちんと追加して下さい。
+テストの前に Postfix の 
+aliases (ユーザ root 宛、postmaster 宛など)をきちんと設定して下さい。
 これをしないと root ＭＬとかが作れてしまいます;-)
 </para>
 
@@ -40,8 +41,8 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 </warning>
 
 <para>
-以下では、&fml8; と MTA が動いているホスト(ahodori.fml.org)をメールサー
-バと呼びます。
+以下では、&fml8; と 
+MTA が動いているホスト(ahodori.fml.org)をメールサーバと呼びます。
 </para>
 
 </sect1>
@@ -62,13 +63,19 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 ここでは、ユーザ「るど」くん rudo@fml.org を例にとります。
 <footnote>
 <para>
-簡単に用意するには、ユーザ rudo くんを作ればよいでしょう。
+簡単に用意するには、単に OS 上にユーザ rudo くんを作ればよいでしょう。
+<screen>
+例:
+
+% su root
+# useradd rudo
+</screen>
 </para>
 </footnote>
 </para>
 
 <para>
-そのホスト上で rudo くんにメールが届くかも試して下さい。
+そのホスト上で rudo くんにメールが届くかを試して下さい。
 つまり ahodori の上で rudo@fml.org へメールを出してください。
 <screen>
 % echo test |Mail rudo@fml.org
@@ -77,16 +84,21 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。
 </para>
 
 <para>
-次に、メールサーバ以外のホストから rudo@fml.org へメールが届くか？(到
-達性)を確認して下さい。つまり、メールサーバ以外のホストから
-rudo@fml.org くんにメールを出し、ちゃんと受信できているかを確認してく
-ださい。もし受けとれないなら、そもそも Postfix の設定が間違っています。
+次に、メールサーバ以外のホストから rudo@fml.org へメールが届くか？
+(到達性)を確認して下さい。つまり、メールサーバ以外のホストから
+rudo@fml.org くんにメールを出し、ちゃんと受信できているかを確認してください。
+もし受けとれないなら、そもそも Postfix の設定が間違っています。
 </para>
 
 <para>
-少なくとも、この二点のパターンが動作するなら Postfix の基本設定が正し
-いといえるでしょう。Postfix の基本設定が確認できたらＭＬのテストに進ん
-で下さい。
+少なくとも、この二点
+<screen>
+(1) ローカルにメールが送信できる(受信に成功した)
+(2) リモートからメールが送信できる(受信に成功した)
+</screen>
+のパターンが動作するなら
+Postfix の基本設定が正しいといえるでしょう。
+Postfix の基本設定が確認できたらＭＬのテストに進んで下さい。
 </para>
 
 </sect1>
@@ -110,12 +122,27 @@ rudo@fml.org を登録して下さい。
 <para>
 前節と同様に、ホスト外から、そしてホストの上から、それぞれ
 elena@fml.org へテストメールを出してみて下さい。 
-この時、テストメールの From: が rudo@fml.org になっていないと
-はじかれます。
+この時、テストメールの 
+From: が rudo@fml.org になっていないと SPAM 扱いされます。
 メンバー以外からのメールは受け付けないからです。
 注意して下さい。
 </para>
 
+<warning>
+<para>
+SPAM 扱いですが、2008/08/03 以降の &fml8; では
+「ログに isolated と表示されメールは隔離される」のがデフォルトです。
+それ以前の &fml8; では、
+送信者に「あなたはＭＬのメンバーではないので投稿は拒否された」と
+メールが返されていました。
+</para>
+
+<para>
+SPAM が多いので「隔離」がデフォルト値に変更してあります。
+</para>
+</warning>
+
+
 <sect2>
 	<title>
 	確認事項
diff --git a/fml/doc/ja/tutorial/threadtrack/tools.sgml b/fml/doc/ja/tutorial/threadtrack/tools.sgml
index 83904a13..b3c8dab2 100644
--- a/fml/doc/ja/tutorial/threadtrack/tools.sgml
+++ b/fml/doc/ja/tutorial/threadtrack/tools.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: tools.sgml,v 1.3 2002/04/01 23:41:07 fukachan Exp $
+   $FML: tools.sgml,v 1.4 2003/04/15 14:51:45 fukachan Exp $
 -->
 
 <appendix id="pmtools">
@@ -55,7 +55,7 @@ http://linas.org/linux/pm.html
 <para>
 どちらかというと有名なものは特定のプロジェクトと bind されていて
 そこから派生したという趣が多いようにおもえます。
-例えば perl.org のバグトラックツールである perlbug (CPAN を見よ) は
+たとえば perl.org のバグトラックツールである perlbug (CPAN を見よ) は
 他であまり使われているような気がしないわけで、
 どうも project が発生するたびに、
 『既存の bug tracking system は使いにくい、作ろう』
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
index e2775210..475f1415 100644
--- a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
+++ b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML: recipes.sgml,v 1.5 2008/08/19 07:11:02 fukachan Exp $
+ $FML: recipes.sgml,v 1.6 2009/12/26 13:33:26 fukachan Exp $
 -->
 
 
@@ -82,9 +82,9 @@ WWW サーバの処理の段階で何かがおかしいです。
 </para>
 
 <para>
-中途半端にＭＬがセットアップされている（例えばホームディレクトリはある
-が、aliases に反映されていない）場合には、fml のログファイル(例:
-/var/spool/ml/elena/log)を見てみて下さい。
+中途半端にＭＬがセットアップされている
+(たとえばホームディレクトリはあるが、aliases に反映されていない)
+場合には、fml のログファイル(例: /var/spool/ml/elena/log)を見てみて下さい。
 </para>
 
 </answer>
diff --git a/fml/doc/ja/tutorial/usage/fmldoc.sgml b/fml/doc/ja/tutorial/usage/fmldoc.sgml
index 9f15d7cb..7f1c2bd0 100644
--- a/fml/doc/ja/tutorial/usage/fmldoc.sgml
+++ b/fml/doc/ja/tutorial/usage/fmldoc.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fmldoc.sgml,v 1.3 2002/07/28 06:26:58 fukachan Exp $
+   $FML: fmldoc.sgml,v 1.4 2004/10/06 09:07:44 fukachan Exp $
 -->
 
 
@@ -15,7 +15,7 @@ fml の任意のモジュールに対し、そのドキュメントを表示します。
 </para>
 
 <para>
-例えば、FML::Process::Kernel のドキュメントが見たい場合、
+たとえば、FML::Process::Kernel のドキュメントが見たい場合、
 <screen>
 % fmldoc FML::Process::Kernel
 </screen>
diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml
index 9597a0c1..b2d1241e 100644
--- a/fml/doc/ja/tutorial/usage/post.sgml
+++ b/fml/doc/ja/tutorial/usage/post.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: post.sgml,v 1.11 2008/08/19 07:11:02 fukachan Exp $
+   $FML: post.sgml,v 1.12 2009/12/26 13:33:26 fukachan Exp $
 -->
 
 
@@ -92,7 +92,7 @@ symlink(2) で結ばれ、同一のファイルです。
 /usr/local/libexec/fml/distribute が起動されると、つまり loader が起動
 されると、/usr/local/libexec/fml/loader は /usr/local/etc/fml/main.cf 
 を読みこみます。そして fml_version 変数から使うべきライブラリのバージョ
-ンを決めます。例えば fml_vesrion が current-20010501 となっていたら
+ンを決めます。たとえば fml_vesrion が current-20010501 となっていたら
 /usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといっ
 た具合です。
 </para>