clean up. update/fix descriptions.

6 files changed, 417 insertions, 190 deletions

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>