add installation recipes

6 files changed, 442 insertions, 5 deletions

diff --git a/fml/doc/en/tutorial/include/chapters.ent b/fml/doc/en/tutorial/include/chapters.ent
index 7da92630..dc8ff0fb 100644
--- a/fml/doc/en/tutorial/include/chapters.ent
+++ b/fml/doc/en/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapters.ent,v 1.3 2005/07/20 10:37:41 fukachan Exp $
+   $FML: chapters.ent,v 1.4 2005/10/08 03:37:42 fukachan Exp $
    $jaFML: chapters.ent,v 1.75 2003/06/20 22:03:12 fukachan Exp $
 -->
 
@@ -40,6 +40,7 @@
 <!entity sect.install.postfix     SYSTEM "install/postfix.sgml">
 <!entity sect.install.qmail       SYSTEM "install/qmail.sgml">
 <!entity chapter.upgrade          SYSTEM "install/upgrade.sgml">
+<!entity sect.install.recipes     SYSTEM "install/recipes.sgml">
 
 <!entity chapter.setup.newml      SYSTEM "setup/newml.sgml">
 <!entity sect.setup.postfix       SYSTEM "setup/postfix.sgml">
diff --git a/fml/doc/en/tutorial/install/fml_on_unix.sgml b/fml/doc/en/tutorial/install/fml_on_unix.sgml
index d8f3a850..6a73cac5 100644
--- a/fml/doc/en/tutorial/install/fml_on_unix.sgml
+++ b/fml/doc/en/tutorial/install/fml_on_unix.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fml_on_unix.sgml,v 1.2 2005/07/23 01:57:39 fukachan Exp $
+   $FML: fml_on_unix.sgml,v 1.3 2005/09/24 13:53:42 fukachan Exp $
    $jaFML: fml_on_unix.sgml,v 1.5 2003/04/15 14:51:39 fukachan Exp $
 -->
 
@@ -510,5 +510,14 @@ site_default_config.cf is applied to all domains.
 &sect.install.postfix;
 &sect.install.qmail;
 
+<!-- recipes -->
+<!-- recipes -->
+<sect1 id="install.recipes">
+	<title> 
+	recipes
+	</title> 
+
+	&sect.install.recipes;
+</sect1>
 
 </chapter>
diff --git a/fml/doc/en/tutorial/install/recipes.sgml b/fml/doc/en/tutorial/install/recipes.sgml
new file mode 100644
index 00000000..663f0015
--- /dev/null
+++ b/fml/doc/en/tutorial/install/recipes.sgml
@@ -0,0 +1,217 @@
+<!--
+ $FML$
+
+   ユーザ fml 以外(例えば自分)で fml を使いたい
+   current, stable, release どれをダウンロードするべき？
+   インストールの際にユーザ fml になるタイミングは？
+   ドキュメント抜きのインストールをしたい
+   インストール後に /usr/local/fml/doc を消したい
+   ユーザ root でインストールしたい
+   インストール時に perl のパスを指定したい
+   jperl で fml を使いたい
+   elena ML を上書きしたい
+   /var/spool/ml/etc/aliases をカスタマイズしたい
+   メールサーバは Unix で稼働させ fml は Windows 2000/NT4 で動かしたい
+   ロックをせずに上書きインストールをしたい
+    ML を初期化したい
+
+-->
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we use other user as fml process ?
+</para>
+</question>
+
+<answer>
+<para>
+Run configure with --with-fml-owner option.
+<screen>
+configure --with-fml-owner=$USER
+</screen>
+</para>
+
+<para>
+Do not use your own account but use fml specific user for all fml processes.
+</para>
+
+<para>
+Please use procmail et.al. if fml processes are kicked off by .forward
+not aliases. See /var/spool/ml/etc/procmail/procmailrc for more
+details on procmail usage.
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+When should we change use to fml in installation ?
+</para>
+</question>
+
+<answer>
+<para>
+In installation.
+</para>
+
+<para>
+You can download source code and run configure by not user root
+(e.g. user fml), but run "make install" by user root.
+It may be better to run by user too always.
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we install &fml8; without document.
+</para>
+</question>
+
+<answer>
+<para>
+Yes by default.
+&fml8; does not install document.
+If you need documentation, please install ./SOURCE/Documentation/ into
+/usr/local/share/doc/fml8/$FML_VERSION/.
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we specify per path in installation ?
+</para>
+</question>
+
+<answer>
+<para>
+No directly. Run configure with proper environment variable PATH.
+<screen>
+% env PATH=/some/where/:$PATH sh configure
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we use jperl ?
+</para>
+</question>
+
+<answer>
+<para>
+Unknown.
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we overwrite elena ML ?
+</para>
+</question>
+
+<answer>
+<para>
+Run "makefml newml" with --force option.
+<screen>
+% makefml --force newml elena
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we edit alias files under /var/spool/ml/etc ?
+</para>
+</question>
+
+<answer>
+<para>
+Yes but please control them by yourself. These files are controlled by
+makefml/fml scripts. These scripts edit them. If the ML is removed,
+the corresponding entries are removed and cannot be back.
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we use &fml7; on Windows 2000/NT4 but MTA on Unix server ?
+</para>
+</question>
+
+<answer>
+<para>
+Caution: not tested.
+</para>
+
+<para>
+It can be. Run fetchfml on Windows 2000 or NT4 and run MTA on Unix.
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+Can we initialize ML ?
+</para>
+</question>
+
+<answer>
+<para>
+It is easy to run rmml once and newml again.
+<screen>
+% makefml rmml elena
+% makefml newml elena
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+
+</qandaset>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index da78b205..dd162d8c 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.94 2005/09/30 13:24:09 fukachan Exp $
+	$FML: chapters.ent,v 1.95 2005/10/08 03:37:43 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -39,6 +39,7 @@
 <!entity sect.install.postfix     SYSTEM "install/postfix.sgml">
 <!entity sect.install.qmail       SYSTEM "install/qmail.sgml">
 <!entity chapter.upgrade          SYSTEM "install/upgrade.sgml">
+<!entity sect.install.recipes     SYSTEM "install/recipes.sgml">
 
 <!entity chapter.setup.newml      SYSTEM "setup/newml.sgml">
 <!entity sect.setup.postfix       SYSTEM "setup/postfix.sgml">
diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml
index b49a3179..9bc79863 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.9 2004/10/09 12:09:28 fukachan Exp $
+   $FML: fml_on_unix.sgml,v 1.10 2005/06/25 15:11:32 fukachan Exp $
 -->
 
 
@@ -398,7 +398,7 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共
 デフォルトでは &fml4; と合わせるために、および見本として:)
 subject のタグをつけない設定とフィルタ関連の設定だけが入っています。
 <screen>
-# $FML: fml_on_unix.sgml,v 1.9 2004/10/09 12:09:28 fukachan Exp $
+# $FML: fml_on_unix.sgml,v 1.10 2005/06/25 15:11:32 fukachan Exp $
 #
 #               site default_config.cf EXAMPLE
 #
@@ -521,5 +521,13 @@ site_default_config.cf はドメインに関わらず適用されることに注意してく
 &sect.install.postfix;
 &sect.install.qmail;
 
+<!-- recipes -->
+<sect1 id="install.recipes">
+	<title> 
+	recipes
+	</title> 
+
+	&sect.install.recipes;
+</sect1>
 
 </chapter>
diff --git a/fml/doc/ja/tutorial/install/recipes.sgml b/fml/doc/ja/tutorial/install/recipes.sgml
new file mode 100644
index 00000000..4c85f0ea
--- /dev/null
+++ b/fml/doc/ja/tutorial/install/recipes.sgml
@@ -0,0 +1,201 @@
+<!--
+ $FML$
+-->
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+ユーザ fml 以外(例えば自分)で fml を使いたい
+</para>
+</question>
+
+<answer>
+<para>
+fml を動かすプロセスのユーザ fml を他のユーザにしたいのであれば、
+configure オプションの  --with-fml-owner で変更できます。
+</para>
+
+<para>
+自分のアカウントで実行するのはやめましょう。fml 専用ユーザを用意するこ
+とが推奨です。
+</para>
+
+<para>
+aliases からの起動ではなく、
+一般ユーザの権限としてＭＬを実行するのであれば
+procmail の利用を考えてみて下さい。
+設定は /var/spool/ml/etc/procmail/procmailrc を参考にして下さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+インストールの際にユーザ fml になるタイミングは？
+</para>
+</question>
+
+<answer>
+<para>
+ダウンロードと configure の実行はユーザ fml で行なってもかまいませんが、
+インストールはユーザ root で行なって下さい。
+</para>
+
+<para>
+ダウンロードからインストールまで全てユーザ root で行なってもよいでしょ
+う。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ドキュメント抜きのインストールをしたい
+</para>
+</question>
+
+<answer>
+<para>
+現在、&fml8; はドキュメントをインストールしません。 逆に、ドキュメント
+が必要ならソースの Documentation/ 以下を適切な場所(たとえば 
+/usr/local/share/doc/fml8/バージョン番号/)にコピーして下さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+インストール時に perl のパスを指定したい
+</para>
+</question>
+
+<answer>
+<para>
+configure を実行する際に環境変数 PATH を適切に設定しつつ
+実行して下さい。
+<screen>
+% env PATH=/some/where/:$PATH sh configure 
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+jperl で fml を使いたい
+</para>
+</question>
+
+<answer>
+<para>
+動くかどうかまったく分かりません。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+elena ML を上書きしたい
+</para>
+</question>
+
+<answer>
+<para>
+--force つきで newml を実行して下さい。 
+<screen>
+% makefml --force newml elena
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+/var/spool/ml/etc/ 以下の aliases ファイルを編集しても大丈夫ですか？
+</para>
+</question>
+
+<answer>
+<para>
+はい、編集してもかまいませんが内容は自分で管理するようにして下さい。本
+来そこは makefml/fml が自動で編集するところですので、ＭＬを消せば削除
+されますし、削除後にＭＬ復活を行なっても元には戻りませんので注意して下
+さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+メールサーバは Unix で稼働させ fml は Windows 2000/NT4 で動かしたい
+</para>
+</question>
+
+<answer>
+<para>
+注意: テストしていないです。
+</para>
+
+<para>
+fetchfml を Windows 2000/NT4 で動かし、
+MTA を Unix で動かせば良いでしょう。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ML を初期化したい
+</para>
+</question>
+
+<answer>
+<para>
+いちど rmml して、もういちど newml を実行するのが簡単です。
+<screen>
+% makefml rmml elena
+% makefml newml elena
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>