overhaul

5 files changed, 135 insertions, 35 deletions

diff --git a/fml/doc/ja/tutorial/install/download.sgml b/fml/doc/ja/tutorial/install/download.sgml
index 9e47fe90..b70b576c 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.4 2004/10/06 09:07:36 fukachan Exp $
+   $FML: download.sgml,v 1.5 2008/08/07 01:03:16 fukachan Exp $
 -->
 
 
@@ -25,10 +25,20 @@
 
 <para>
 開発の適当な区切りごとに、不定期に作成されています。
+現在のファイル名は
+<screen>
+fml-VERSION-DATA.tar.gz
+</screen>
+形です。
+VERSION は 8.0 正式リリース以前なのでなので 8.0 より少し小さい値
+7.98.x などとなっています。
 ファイル名に日付が入っていますので、
 日付の新しいものを選んでダウンロードして下さい。
 </para>
 
+<!--
+	XXX-TODO: daily snapshots
+
 <para>
 なお daily snapshot もあります。
 全自動で作られているので、特定の日のバージョンはうまく動かないかも知れ
@@ -40,6 +50,7 @@
 ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/
 </ulink>
 </para>
+-->
 
 </sect1>
 
diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
index 4a30a41b..b53527dd 100644
--- a/fml/doc/ja/tutorial/install/fml_on_unix.sgml
+++ b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
@@ -1,11 +1,11 @@
 <!--
-   $FML: fml_on_unix.sgml,v 1.11 2005/10/08 07:32:54 fukachan Exp $
+   $FML: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
 -->
 
 
 <chapter id="install.fml.unix">
 	<title>
-	UNIX 上での fml のインストール
+	Unix 上での fml のインストール
 	</title>
 
 
@@ -64,10 +64,10 @@ make install を実行すると、configure が生成した etc/fml/install.cf を
 fml では各ディレクトリにさらに /fml といった suffix をつけます。
 変更できるのは、その直前の prefix 部分までです。
 <screen>
-変数            configure のデフォルト値    fml の利用するディレクトリ
+変数            configure のデフォルト値    fml の利用するディレクトリ例
 --------------------------------------------------------
 prefix          /usr/local                  /usr/local
-exec_prefix     /usr/local
+exec_prefix     /usr/local                  /usr/local
 bindir          ${exec_prefix}/bin          /usr/local/bin
 sbindir         ${exec_prefix}/sbin         /usr/local/sbin
 libexecdir      ${exec_prefix}/libexec      /usr/local/libexec/fml
@@ -114,7 +114,7 @@ configure --help
 	</title>
 
 <para>
-例: NetBSD は /usr/pkg 以下だね 
+例: NetBSD は /usr/pkg 以下へ。
 <screen>
 % ./configure --prefix=/usr/pkg
 </screen>
@@ -398,7 +398,7 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
 デフォルトでは &fml4; と合わせるために、および見本として:)
 subject のタグをつけない設定とフィルタ関連の設定だけが入っています。
 <screen>
-# $FML: fml_on_unix.sgml,v 1.11 2005/10/08 07:32:54 fukachan Exp $
+# $FML: fml_on_unix.sgml,v 1.12 2005/11/19 03:45:07 fukachan Exp $
 #
 #               site default_config.cf EXAMPLE
 #
@@ -483,6 +483,20 @@ use_mime_component_filter	=	yes
 をカスタマイズしてください。
 </para>
 
+<warning>
+<para>
+ただ、仕事のメールで添付ファイルなしは厳しいようなので、
+社内向けメールなど仕事用のＭＬサーバとして使うなら、
+インストール後、すぐに
+<screen>
+[/usr/local/etc/fml/site_default_config.cf]
+
+use_mime_component_filter	=	no
+</screen>
+に変更しておくとよいでしょう。
+</para>
+</warning>
+
 </sect1>
 
 
diff --git a/fml/doc/ja/tutorial/install/postfix.sgml b/fml/doc/ja/tutorial/install/postfix.sgml
index de698a30..d3b2f122 100644
--- a/fml/doc/ja/tutorial/install/postfix.sgml
+++ b/fml/doc/ja/tutorial/install/postfix.sgml
@@ -1,18 +1,45 @@
 <!--
-   $FML: postfix.sgml,v 1.5 2004/10/06 09:07:37 fukachan Exp $
+   $FML: postfix.sgml,v 1.6 2005/06/25 15:11:32 fukachan Exp $
 -->
 
 
 <sect1 id="install.postfix">
 	<title>
-	メールサーバの設定 (postfix)
+	メールサーバの設定 (Postfix)
 	</title>
 
 <para>
-makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
-め postfix の設定を変更しておいて下さい。
+makefml newml を実行するだけでＭＬが自動的に有効になるように、
+次のように Postfix の設定を変更して下さい。
 </para>
 
+<caution>
+<para>
+一つのドメインについては、一度 Postfix の設定をすれば、あとは makefml 
+ないしは fml コマンドの操作だけでＭＬの作成、削除が可能になりますが、
+別のドメインを使うなら、ドメインごとに Postfix の alias_maps と 
+virtual_maps の追加設定が必要になることに注意して下さい。
+</para>
+
+
+</caution>
+
+
+<sect2>
+	<title>
+	Postfix からプログラムを実行可能にする。	
+	</title>
+
+<para>
+<screen>
+allow_mail_to_commands = alias,forward,include
+</screen>
+の設定を入れて下さい。
+これはＭＬドライバを実行するためにどんなケースでも必須の設定です。
+</para>
+
+</sect2>
+
 
 <sect2>
 	<title>
@@ -23,13 +50,29 @@ makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ
 <para>
 具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。
 <screen>
+# Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
 alias_maps	=	hash:/etc/mail/aliases
 			hash:/var/spool/ml/etc/mail/aliases
 </screen>
+hash:/var/spool/ml/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">
+</link>
+の章を参照。
 </para>
 
+<!--
+XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
+-->
+
 <warning>
 <para>
 また mydestination にデフォルトのドメイン(おそらく $mydomain )が
@@ -49,6 +92,7 @@ alias_maps	=	hash:/etc/mail/aliases
 /etc/postfix/main.cf で
 alias_maps と virtual_maps の両方に設定の追加が必要です。
 <screen>
+# Postfix からプログラムを実行可能にする。
 allow_mail_to_commands = alias,forward,include
 
 alias_maps	=	hash:/etc/mail/aliases
@@ -62,27 +106,37 @@ makefml newml を実行すると
 /var/spool/nuinui.net/etc/mail/aliases
 および
 /var/spool/nuinui.net/etc/postfix/virtual 
-は makefml によって自動的に更新されます。
-なお、この場合、ml_home_prefix_maps で
+は makefml によって自動的に更新されます(画面に表示されるので分かるはず)。
+なお、この場合、事前に ml_home_prefix_maps で
 <screen>
 nuinui.net /var/spool/nuinui.net
 </screen>
 という「ドメイン←→ディレクトリ」の定義がなされています。
+newml コマンドの使い方についての詳細は
+<link linkend="install.fml.unix">
+<xref linkend="install.fml.unix">
+</link>
+の章を参照。
 </para>
 
+<!--
+XXX-TODO: newml の際に、Postfix の設定のヒントを表示するべきでしょう。
+-->
+
 <warning>
 
 <para>
 &fml8; が作る virtual_maps のファイルは Postfix スタイルの 
 virtual_maps です。最近の Postfix には sendmail スタイルというのもあり
-ますが、ここでは昔からある postfix スタイルを使っているということに注
-意して下さい。
+ますが、&fml8; では昔からある postfix スタイルを使っているということに
+注意して下さい。
 </para>
 
 <para>
-mydestination にデフォルトのドメイン(おそらく $mydomain)がちゃんと追加
-されていることを確認して下さい。しかし、バーチャルドメイン(ここでは 
-nuinui.net)は mydestination に追加する必要はありません。注意して下さい。
+mydestination には、デフォルトのドメイン(おそらく $mydomain)を入れるこ
+とが普通ですが、バーチャルドメイン(ここでは nuinui.net)は 
+mydestination に追加する必要はありません(Postfix は virtual_maps の値
+を見て mydestination 相当であるとみなしています)。注意して下さい。
 </para>
 
 <para>
diff --git a/fml/doc/ja/tutorial/install/recipes.sgml b/fml/doc/ja/tutorial/install/recipes.sgml
index 4c85f0ea..00b5550e 100644
--- a/fml/doc/ja/tutorial/install/recipes.sgml
+++ b/fml/doc/ja/tutorial/install/recipes.sgml
@@ -1,5 +1,5 @@
 <!--
- $FML$
+ $FML: recipes.sgml,v 1.1 2005/10/08 07:32:54 fukachan Exp $
 -->
 
 <qandaset>
@@ -50,8 +50,7 @@ procmail の利用を考えてみて下さい。
 </para>
 
 <para>
-ダウンロードからインストールまで全てユーザ root で行なってもよいでしょ
-う。
+ダウンロードからインストールまで全てユーザ root で行なっても問題ありません。
 </para>
 </answer>
 
@@ -119,7 +118,7 @@ jperl で fml を使いたい
 
 <question>
 <para>
-elena ML を上書きしたい
+elena ML を上書き(再生成)したい
 </para>
 </question>
 
@@ -145,10 +144,10 @@ elena ML を上書きしたい
 
 <answer>
 <para>
-はい、編集してもかまいませんが内容は自分で管理するようにして下さい。本
-来そこは makefml/fml が自動で編集するところですので、ＭＬを消せば削除
-されますし、削除後にＭＬ復活を行なっても元には戻りませんので注意して下
-さい。
+はい、編集してもかまいませんが内容は自分で管理するようにして下さい。
+ただ、本来そこは makefml/fml が自動で編集するところですので、ＭＬを消
+せば削除されますし、削除後にＭＬ復活を行なっても元には戻りませんので、
+注意して下さい。
 </para>
 </answer>
 
@@ -181,7 +180,7 @@ MTA を Unix で動かせば良いでしょう。
 
 <question>
 <para>
-ML を初期化したい
+ＭＬを初期化(再初期化)したい
 </para>
 </question>
 
@@ -198,4 +197,20 @@ ML を初期化したい
 </qandaentry>
 
 
+<qandaentry>
+<question>
+	<para>
+	間違えて rmml してしまったＭＬを復活させたい
+	</para>
+</question>
+
+<answer>
+	<para>
+	reviveml コマンドを使って下さい。
+	</para>
+</answer>
+</qandaentry>
+
+
+
 </qandaset>
diff --git a/fml/doc/ja/tutorial/install/upgrade.sgml b/fml/doc/ja/tutorial/install/upgrade.sgml
index e5ca9a12..a9c67b1c 100644
--- a/fml/doc/ja/tutorial/install/upgrade.sgml
+++ b/fml/doc/ja/tutorial/install/upgrade.sgml
@@ -1,22 +1,22 @@
 <!--
-   $FML: upgrade.sgml,v 1.7 2004/10/06 09:07:37 fukachan Exp $
+   $FML: upgrade.sgml,v 1.8 2005/06/25 15:11:33 fukachan Exp $
 -->
 
 
 <chapter id="xxxgrade">
 	<title>
-	fml8 のアップグレード/ダウングレード
+	&fml8; のアップグレード/ダウングレード
 	</title>
 
 <warning>
 
 <para>
-本章では fml8 のバージョンをアップグレード/ダウングレードする方法につ
+本章では &fml8; のバージョンをアップグレード/ダウングレードする方法につ
 いて解説します。
 </para>
 
 <para>
-fml4 から fml8 へのアップグレードは、
+&fml4; から &fml8; へのアップグレードは、
 <link linkend="mergeml.fml4to8">
 <xref linkend="mergeml.fml4to8">
 </link>
@@ -28,12 +28,18 @@ fml4 から fml8 へのアップグレードは、
 
 <sect1 id="upgrade">
 	<title>
-	fml8 のアップグレード
+	&fml8; のアップグレード
 	</title>
 
+<warning>
 <para>
 インストールするだけでは何も変化は起こりません。
-まずは、単に、もう一度 fml8 を
+main.cf を編集した瞬間にアップグレードが有効になります。
+</para>
+</warning>
+
+<para>
+まずは、単に、もう一度 &fml8; を
 <link linkend="install.fml.unix">
 インストール
 </link>
@@ -43,7 +49,7 @@ fml4 から fml8 へのアップグレードは、
 <para>
 そして、インストール後、/usr/local/etc/fml/main.cf の fml_version 行を
 今インストールしたバージョンに変更して下さい。
-ファイルをセーブした瞬間から新しい fml8 に切り替わります
+ファイルをセーブした瞬間から新しい &fml8; に切り替わります
 (注: エディタで編集中は古い内容)。
 </para>
 
@@ -56,7 +62,7 @@ fml4 から fml8 へのアップグレードは、
 
 <sect1 id="downgrade">
 	<title>
-	fml8 のダウングレード
+	&fml8; のダウングレード
 	</title>
 
 <para>