add recipes around operations, command troubles.

10 files changed, 425 insertions, 5 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 3d00a8b4..842e861c 100644
--- a/fml/doc/ja/tutorial/book.sgml
+++ b/fml/doc/ja/tutorial/book.sgml
@@ -2,7 +2,7 @@
 This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
 to generate various output formats.
 
-$FML: book.sgml,v 1.69 2005/09/30 13:25:08 fukachan Exp $
+$FML: book.sgml,v 1.70 2005/11/27 09:13:34 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -118,6 +118,8 @@ $FML: book.sgml,v 1.69 2005/09/30 13:25:08 fukachan Exp $
 
 	&chapter.op.log;
 	&chapter.op.backup;
+	&chapter.op.archive;
+	&chapter.op.move;
   </part>
 
 
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index cc2b709b..ca213b35 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.108 2006/01/16 12:02:07 fukachan Exp $
+	$FML: chapters.ent,v 1.109 2006/01/17 04:46:04 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -196,6 +196,11 @@
 <!entity chapter.op.log              SYSTEM "operations/log.sgml">
 <!entity chapter.op.backup           SYSTEM "operations/backup.sgml">
 <!entity sect.op.log.recipes         SYSTEM "operations/recipes.log.sgml">
+<!entity chapter.op.archive          SYSTEM "operations/archive.sgml">
+<!entity op.archive.recipes          SYSTEM "operations/recipes.archive.sgml">
+<!entity chapter.op.move             SYSTEM "operations/move.sgml">
+<!entity op.move.recipes             SYSTEM "operations/recipes.move.sgml">
+<!entity op.cvs.recipes              SYSTEM "operations/recipes.cvs.sgml">
 
 
 <!-- misc -->
@@ -223,6 +228,7 @@
 <!entity chapter.troubleshoot         SYSTEM "troubleshoot/chapter.sgml">
 <!entity troubleshoot.recipes         SYSTEM "troubleshoot/recipes.sgml">
 <!entity troubleshoot.recipes.message SYSTEM "troubleshoot/recipes.message.sgml">
+<!entity troubleshoot.recipes.command SYSTEM "troubleshoot/recipes.command.sgml">
 
 
 <!entity troubleshoot.version.recipes SYSTEM "troubleshoot/recipes.version.sgml">
diff --git a/fml/doc/ja/tutorial/operations/archive.sgml b/fml/doc/ja/tutorial/operations/archive.sgml
new file mode 100644
index 00000000..3f2a8b39
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/archive.sgml
@@ -0,0 +1,25 @@
+<!--
+ $FML$
+-->
+
+
+<chapter id="archive">
+	<title>
+	アーカイブ
+	</title>
+
+<para>
+未実装です。
+</para>
+
+<sect1 id="archive.recipes">
+	<title>
+	レシピ’s
+	</title>
+
+&op.archive.recipes;
+
+</sect1>
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/operations/backup.sgml b/fml/doc/ja/tutorial/operations/backup.sgml
index 0bcca339..c30fc54c 100644
--- a/fml/doc/ja/tutorial/operations/backup.sgml
+++ b/fml/doc/ja/tutorial/operations/backup.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: backup.sgml,v 1.2 2004/04/07 11:07:10 fukachan Exp $
+   $FML: backup.sgml,v 1.3 2004/10/06 09:07:41 fukachan Exp $
 -->
 
 
@@ -161,4 +161,14 @@ rsync でバックアップする場合なら、--exclude オプションなどで、これらの
 </sect1>
 
 
+<sect1 id="operations.backup.recipes">
+	<title>
+	レシピ’s
+	</title>
+
+&op.cvs.recipes;
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/operations/recipes.archive.sgml b/fml/doc/ja/tutorial/operations/recipes.archive.sgml
new file mode 100644
index 00000000..e21f3959
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/recipes.archive.sgml
@@ -0,0 +1,93 @@
+<!--
+ $FML$
+-->
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+記事のスプールを圧縮する
+</para>
+</question>
+
+<answer>
+<para>
+未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+スプールを自動で消したい
+</para>
+</question>
+
+<answer>
+<para>
+未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+手動でアーカイブを作りたい
+</para>
+</question>
+
+<answer>
+<para>
+アーカイブ機能は未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+   
+<qandaentry>
+
+<question>
+<para>
+アーカイブから記事を get コマンドで取り出す
+</para>
+</question>
+
+<answer>
+<para>
+アーカイブ機能は未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+アーカイブごと get したい
+</para>
+</question>
+
+<answer>
+<para>
+アーカイブ機能は未実装です。
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>
diff --git a/fml/doc/ja/tutorial/operations/recipes.cvs.sgml b/fml/doc/ja/tutorial/operations/recipes.cvs.sgml
new file mode 100644
index 00000000..5f97261d
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/recipes.cvs.sgml
@@ -0,0 +1,27 @@
+<!--
+ $FML$
+-->
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+設定ファイルをバージョン管理したい
+</para>
+</question>
+
+<answer>
+<para>
+まだ &fml8; が自動で cvs を走らせるようになっていませんので、
+ときどき手動で行なって下さい。
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>
+
diff --git a/fml/doc/ja/tutorial/operations/recipes.move.sgml b/fml/doc/ja/tutorial/operations/recipes.move.sgml
new file mode 100644
index 00000000..9e8e5d44
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/recipes.move.sgml
@@ -0,0 +1,27 @@
+<!--
+ $FML$
+-->
+
+<qandaset>
+
+
+<qandaentry>
+
+<question>
+<para>
+メールサーバを引越ししますが、
+IP アドレスの変更に関係のある &fml8; のファイルはありますか？
+</para>
+</question>
+
+<answer>
+<para>
+ありません。
+</para>
+</answer>
+
+</qandaentry>
+
+
+</qandaset>
+
diff --git a/fml/doc/ja/tutorial/troubleshoot/chapter.sgml b/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
index b6f9be3b..77aacda3 100644
--- a/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
+++ b/fml/doc/ja/tutorial/troubleshoot/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: chapter.sgml,v 1.8 2006/01/16 10:24:27 fukachan Exp $
+   $FML: chapter.sgml,v 1.9 2006/01/17 04:46:04 fukachan Exp $
 -->
 
 
@@ -21,6 +21,7 @@
 &troubleshoot.address.recipes;
 &troubleshoot.recipes;
 &troubleshoot.recipes.message;
+&troubleshoot.recipes.command;
 
 </qandaset>
 
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.command.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.command.sgml
new file mode 100644
index 00000000..d67d575f
--- /dev/null
+++ b/fml/doc/ja/tutorial/troubleshoot/recipes.command.sgml
@@ -0,0 +1,155 @@
+<!--
+ $FML$
+
+-->
+
+
+<qandaentry>
+
+<question>
+<para>
+help を取り寄せると化けています
+</para>
+</question>
+
+<answer>
+
+<para>
+&fml8; では ISO-2022-JP に変換してから送信していますし、
+ヘッダにも適切な Content-Type: をつけています。
+</para>
+
+<para>
+化けるようなら、これらの処理を行なうモジュールがうまく動作していない可
+能性があります。ヘッダの確認と、そのメールの文字コードの確認をしてみて
+ください。
+</para>
+
+<para>
+また、そのヘルプファイルと、ヘルプを取り寄せるトリガーになったコマンド
+メールを見せていただけるとさいわいです。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+get できない
+</para>
+</question>
+
+<answer>
+<para>
+返されたエラーメッセージおよびログファイルを見てみて下さい。
+</para>
+
+<para>
+ログの no such file は get しようとしたファイルがないということです。
+そのメッセージの後にアクセスしようとしたファイルのフルパスが書いてあるので
+確認してみて下さい。
+</para>
+
+<para>
+ログの invalid argument は指示されたパラメータの何かが不正であった場合
+にでます。また、指定した記事番号が存在しなかった場合にもこのエラーメッ
+セージが出ることがあります。
+</para>
+
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+get で ish モードなどが動かない
+</para>
+</question>
+
+<answer>
+<para>
+特殊な圧縮形式は未サポートです。
+&fml8; の get および mget は送り返す際に MIME/Multipart 形式しか
+サポートしていません。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+subscribe しようとすると無視されるようです？
+</para>
+</question>
+
+<answer>
+<para>
+メールアドレスの表現形式は制限されています。
+表現の範囲は FML::Restriction::Base クラスに定義されており、
+次のようになっています。
+<screen>
+my $domain_regexp  = '[-A-Za-z0-9\.]+';    # domain of user@domain
+my $user_regexp    = '[-A-Za-z0-9\._\+]+'; # user of user@domain
+</screen>
+不正なアドレスの場合、ログに次のように残りつつ無視されます。
+<screen>
+error: unsafe From: アドレス
+error: ignore this request.
+</screen>
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+' を含むアドレスがうまく扱えない
+</para>
+</question>
+
+<answer>
+<para>
+扱えるメールアドレスの表現形式が制限されているためです。
+前レシピ参照。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+"xxx"@yyy.or.jp というアドレスだとうまく subscribe できません。
+</para>
+</question>
+
+<answer>
+<para>
+そもそも、このアドレスには有効なユーザ部分がありません。
+コメントだけですのでエラーになって当然です。
+</para>
+
+<para>
+扱えるメールアドレスの表現形式は制限されています。
+前々レシピも参照。
+</para>
+</answer>
+
+</qandaentry>
+
+
diff --git a/fml/doc/ja/tutorial/troubleshoot/recipes.sgml b/fml/doc/ja/tutorial/troubleshoot/recipes.sgml
index 2d5618a0..4046d3da 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.2 2006/01/15 13:49:57 fukachan Exp $
+ $FML: recipes.sgml,v 1.3 2006/01/16 10:24:27 fukachan Exp $
 -->
 
 
@@ -225,3 +225,77 @@ fml8 は flock(2) 必須ですので、fml8 は動きません(たぶん動くけど動作が
 </answer>
 
 </qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+記事番号が１にもどってしまった
+</para>
+</question>
+
+<answer>
+<para>
+ということは起こらないように作ってあります(記事番号がアップデートでき
+ないならそもそも &fml8; の処理が途中で止まるようになっている)。
+</para>
+
+<para>
+ロジックに抜けがあって起きる可能性があるかもしれませんが、実際にそうい
+う現象がおきてみないとよくわかりません。いまのところ、ないと信じています。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+間違えて消してしまった！
+</para>
+</question>
+
+<answer>
+<para>
+自動でバックアップなどはしてないので打つ手はありません。
+</para>
+
+<para>
+ミスオペレーションの可能性を考えて、つねに
+<link linkend="operations.backup">
+バックアップ
+</link>
+をとっておくべきです。
+</para>
+</answer>
+
+</qandaentry>
+
+
+<qandaentry>
+
+<question>
+<para>
+ディスクが足りない時に消してよいファイルは？
+</para>
+</question>
+
+<answer>
+
+<para>
+安全に消せる領域は、ほとんどありません。
+</para>
+
+<para>
+あえていえば、ねんのため記録している受信したメールおよび送信したメール
+のログである var/mail/incoming や var/mail/outgoing くらいでしょう。ま
+た過去のログが不要であれば log を消すという案もありますが、あまりおす
+すめできません。
+</para>
+
+</answer>
+
+</qandaentry>