summaryrefslogtreecommitdiff
path: root/fml/doc
diff options
context:
space:
mode:
authorfukachan <fukachan>2006-01-15 13:49:56 +0000
committerfukachan <fukachan>2006-01-15 13:49:56 +0000
commite3150321fd9909a486b7b324e2c7bebf124ff9ca (patch)
tree114bae46932863af8d94d69b2c2c4c54576cf699 /fml/doc
parentbc66f3b372f993a8e9977af320642a49d6bb972c (diff)
downloadfml8-e3150321fd9909a486b7b324e2c7bebf124ff9ca.tar.gz
fml8-e3150321fd9909a486b7b324e2c7bebf124ff9ca.tar.bz2
fml8-e3150321fd9909a486b7b324e2c7bebf124ff9ca.zip
add topics picked up at fml bible.
Diffstat (limited to 'fml/doc')
-rw-r--r--fml/doc/ja/tutorial/command/recipes.sgml126
-rw-r--r--fml/doc/ja/tutorial/customize/recipes.delivery.sgml65
-rw-r--r--fml/doc/ja/tutorial/troubleshoot/recipes.sgml143
3 files changed, 327 insertions, 7 deletions
diff --git a/fml/doc/ja/tutorial/command/recipes.sgml b/fml/doc/ja/tutorial/command/recipes.sgml
index 8b7ee674..115d0a03 100644
--- a/fml/doc/ja/tutorial/command/recipes.sgml
+++ b/fml/doc/ja/tutorial/command/recipes.sgml
@@ -1,7 +1,8 @@
<!--
- $FML$
+ $FML: recipes.sgml,v 1.1 2005/11/18 11:44:54 fukachan Exp $
-->
+
<qandaset>
@@ -9,6 +10,129 @@
<question>
<para>
+コマンドメールなどの返事は Reply-To: ではなく From: へ
+</para>
+</question>
+
+<answer>
+<para>
+コマンドメールの送信者(From:)へ返事を返すのがデフォルトの挙動です。
+<screen>
+
+</screen>
+
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+help などのメッセージをアップグレードする
+</para>
+</question>
+
+<answer>
+<para>
+アップグレードすれば自動的にアップグレードされます。
+&fml4; と異なり &fml8; では help コマンドのメッセージテンプレートは
+次のようなパスに存在するからです。
+<screen>
+/usr/local/share/fml/$VERSION/message/euc-jp/user/help
+/usr/local/share/fml/$VERSION/message/us-ascii/user/help
+</screen>
+</para>
+
+<para>
+ただしMLのホームディレクトリに help ファイルがある場合は
+それが help コマンドの返事に使われています。
+よって help ファイルを自分で用意しているなら
+自分で編集してください。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+help メッセージの元ファイルをカスタマイズする。
+</para>
+</question>
+
+<answer>
+<para>
+&fml8; では help コマンドのメッセージテンプレートは次のようなパスに存
+在します。これを編集してしまうというのが第一案。ただし、これをするとバー
+ジョンアップをした際に変更点が無効になってしまいます。
+<screen>
+/usr/local/share/fml/$VERSION/message/euc-jp/user/help
+/usr/local/share/fml/$VERSION/message/us-ascii/user/help
+</screen>
+</para>
+
+<para>
+ML独自の help メッセージは
+MLホームディレクトリの下に「local/share/message/言語/」を作り、
+その下におけば有効になります。
+<screen>
+[Example]
+
+/var/spool/ml/elena/local/share/message/euc-jp/user/help
+/var/spool/ml/elena/local/share/message/us-ascii/user/help
+</screen>
+常にこのファイルが使われるので、
+バージョンアップしても内容は変わりません。
+それが欠点です。
+</para>
+
+<para>
+なおMLのホームディレクトリに help ファイルがある場合は
+それが help コマンドの返事に使われています。
+よって help ファイルを自分で用意しているなら
+自分で編集してください。
+この場合も、常にこのファイルが使われるので、
+バージョンアップしても内容は変わりません。
+それが欠点です。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+confirmation メッセージをカスタマイズする
+</para>
+</question>
+
+<answer>
+<para>
+help メッセージのカスタマイズと同様ですので、
+くわしくは前レシピを参照して下さい。
+<screen>
+/usr/local/share/fml/$VERSION/message/euc-jp/command/confirm
+/usr/local/share/fml/$VERSION/message/us-ascii/command/confirm
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
news というファイルを送り返すコマンドを作る
</para>
</question>
diff --git a/fml/doc/ja/tutorial/customize/recipes.delivery.sgml b/fml/doc/ja/tutorial/customize/recipes.delivery.sgml
index e9b34dd2..58fed74e 100644
--- a/fml/doc/ja/tutorial/customize/recipes.delivery.sgml
+++ b/fml/doc/ja/tutorial/customize/recipes.delivery.sgml
@@ -1,9 +1,72 @@
<!--
- $FML: @recipe_template,v 1.1 2003/01/07 11:39:13 fukachan Exp $
+ $FML: recipes.delivery.sgml,v 1.1 2005/11/28 11:16:47 fukachan Exp $
-->
<qandaset>
+
+<qandaentry>
+
+<question>
+<para>
+MAINTAINER を elena-admin 以外にしたい。
+</para>
+</question>
+
+<answer>
+<para>
+config.cf で maintainer 変数を設定して下さい。
+<screen>
+maintainer = アドレス
+
+[EXAMPLE]
+
+maintainer = admin@example.co.jp
+</screen>
+設定するアドレス( admin@example.co.jp )でメールを受けとれるように
+しておいてください。
+なおメールサーバによってはメールの送信者が自ドメイン以外からの場合、
+受信を拒否することがあるので注意して下さい。
+</para>
+
+<para>
+単にエラーメールなどの受取先を変えたいだけなら、
+maintainer ( elena ML なら elena-admin@fml.org )
+のフォワード先を変更する方が簡単です。
+その設定は /etc/mail/aliases を変更するか、
+$maintainer_recipient_maps で行なえます。
+前者は MTA がフォワード先を変更していますが、
+後者では elena-admin 宛のメールを fml8 が受けて、
+fml8 が $maintainer_recipient_maps にしたがって再配送を行なっています。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+リモート管理者はMLのメンバーでなくても投稿したい。
+</para>
+</question>
+
+<answer>
+<para>
+なにもしなくても構いません。
+次のように設定されているので、&fml8; のデフォルトでそのように動きます。
+<screen>
+member_maps = $primary_member_map
+ $admin_member_maps
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
<qandaentry>
<question>
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
index ad4a6fa2..51360919 100644
--- a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
+++ b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: recipes.sgml,v 1.1 2005/10/29 05:13:11 fukachan Exp $
-->
@@ -24,10 +24,11 @@ fml をインストールしたホスト上から投稿できない
<para>
こういった場合には不完全な情報しか与えられていませんから、メール全体を
-生成するのはコマンドの役目です。ただ、こういった場合に From: の部分が
-「ユーザ」だけとか「ユーザ@ FQDN 」だったりします。
-きちんと「ユーザ@正しいドメイン」の形に生成されるようになっていないと
-&fml8; としては正当なユーザには見えません。
+生成するのは Mail コマンド(もしくは Mail コマンドからメールを渡された
+MTA )の役目です。ただ、こういった場合に From: の部分が「ユーザ」だけと
+か「ユーザ@ FQDN 」だったりします。きちんと「ユーザ@正しいドメイン」
+の形に生成されるようになっていないと&fml8; としては正当なユーザには見
+えません。
</para>
<para>
@@ -39,4 +40,136 @@ fml をインストールしたホスト上から投稿できない
</qandaentry>
+<qandaentry>
+
+<question>
+<para>
+CGI で ML を作成したがメールサーバに反映されていない
+</para>
+</question>
+
+<answer>
+<para>
+ログを見てみて下さい。
+まず WWW サーバ側に出力されているログを確認して下さい。
+fml からのエラーメッセージが記録されている可能性があります。
+<screen>
+/usr/local/apache/logs/error_log
+/usr/local/apache/logs/suexec_log
+</screen>
+MLのホームディレクトリすら出来ていないなら
+(そのMLのログファイルがありませんから)
+これらのログファイルを解析するしか方法がありません。
+</para>
+
+<para>
+中途半端にMLがセットアップされている(例えばホームディレクトリはある
+が、aliases に反映されていない)場合には、fml のログファイル(例:
+/var/spool/ml/elena/log)を見てみて下さい。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+何度も同じメールが来る
+</para>
+</question>
+
+<answer>
+<para>
+<link linkend="troubleshoot.delivery.duplication">
+<xref linkend="troubleshoot.delivery.duplication">
+</link>
+を参照。
+</para>
+</answer>
+
+</qandaentry>
+
+<qandaentry>
+
+<question>
+<para>
+特定の人に配送されてない気がする
+</para>
+</question>
+
+<answer>
+<para>
+<link linkend="troubleshoot.delivery.duplication">
+<xref linkend="troubleshoot.delivery.duplication">
+</link>
+を参照。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+MLのメンバーでないアドレスからエラーメールがくる
+</para>
+</question>
+
+<answer>
+<para>
+(1) MLの受信者の中にメールを転送している人がいると、
+その転送先からエラーメールが管理者へ返ってくる可能性があります。
+</para>
+
+<para>
+(2) SPAM メールです。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+aliases から fml に変更したら 2 通来るようになった。
+</para>
+</question>
+
+<answer>
+
+<para>
+バグではなく MTA の挙動からそうなる可能性はあります。
+たとえば aliases が次のようになっていたとします。
+<screen>
+elena: rudo, kenken, hitomi
+</screen>
+この aliases のMLに
+<screen>
+From: rudo
+To: elena
+Cc: rudo
+
+test
+</screen>
+というメールを投稿したとすると rudo には一通届くだけです。MTA が elena
+MLの受信者を調べ rudo 宛の重複分を取り除くからです。
+</para>
+
+<para>
+elena MLを fml に変更すると、
+この重複削除の効果はなくなります。そのため、
+elena ML経由 rudo 宛にとどく分と
+rudo 宛に直接配送されてくる分の2つになるというわけです。
+</para>
+
+</answer>
+
+</qandaentry>