add chapter on log operations

3 files changed, 101 insertions, 2 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index dfc799ca..680aba95 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.58 2003/05/31 08:51:07 fukachan Exp $
+$FML: book.sgml,v 1.59 2003/11/25 04:18:32 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -93,6 +93,15 @@ $FML: book.sgml,v 1.58 2003/05/31 08:51:07 fukachan Exp $
 
 
   <part>
+	<title>
+	運用
+	</title>
+
+	&chapter.op.log;
+  </part>
+
+
+  <part>
 	<title> トラブルシューティング </title>
 	<partintro>
 	<para>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 6252beaf..daaa806c 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.77 2003/10/22 13:47:30 fukachan Exp $
+	$FML: chapters.ent,v 1.78 2003/11/25 04:18:32 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -171,6 +171,10 @@
 <!entity chapter.program.create      SYSTEM "devel/create_program.sgml">
 
 
+<!-- operations -->
+<!entity chapter.op.log              SYSTEM "operations/log.sgml">
+
+
 <!-- misc -->
 <!entity chapter.threadtrack		SYSTEM "threadtrack/chapter.sgml">
 <!entity sect.threadtrack.states	SYSTEM "threadtrack/states.sgml">
diff --git a/fml/doc/ja/tutorial/operations/log.sgml b/fml/doc/ja/tutorial/operations/log.sgml
new file mode 100644
index 00000000..3f6562ef
--- /dev/null
+++ b/fml/doc/ja/tutorial/operations/log.sgml
@@ -0,0 +1,86 @@
+<!--
+   $FML$
+-->
+
+
+<chapter id="operations.log">
+	<title>
+	ログの扱い
+	</title>
+
+
+<sect1 id="operations.log.see">
+	<title>
+	ログを見る
+	</title>
+
+<para>
+<screen>
+% makefml log ＭＬ名
+% fml     ＭＬ名 log
+</screen>
+で、最近のログ(デフォルトでは 30 行分)が表示されます。
+</para>
+
+</sect1>
+
+
+<sect1 id="operations.log.computeroutput">
+	<title>
+	機械処理向きのログを表示する
+	</title>
+
+<para>
+別のコマンドや独自のCGIなどからfml CUIを呼びだし処理をさせたい場合、
+STDERRなどでログを受けとりたいことがあります。
+</para>
+
+<para>
+そういった場合は、
+<screen>
+% makefml --log-computer-output コマンド ＭＬ名
+% fml --log-computer-output     ＭＬ名 コマンド
+</screen>
+とすると、コマンドの結果が標準出力(STDOUT)へ、
+ログがSTDERRへ出力されます。
+</para>
+
+<para>
+たとえば
+<screen>
+% fml --log-computer-output elena@fml.org list
+rudo@nuinui.net
+1070109341  info lock channel=recipient_map_modify
+1070109342  info unlock channel=recipient_map_modify
+</screen>
+この例（デフォルト）では、
+「時刻(unix time)、ログのレベル(info,warning,errorなど)、メッセージ」
+となっています。
+</para>
+
+<para>
+コマンドラインオプション --log-computer-output は、
+config.cf などで
+<screen>
+use_log_computer_output = yes
+</screen>
+と指定することでも可能です。でも、単にこの変数を yes にすると、
+makefml や fml だけでなく、配送やコマンドメールのプログラムも
+STDERRにログの出力をしてしまいます。
+</para>
+
+<para>
+メッセージのキューイングの内部構造や出力フォーマットは、ある perl
+module のなかに押し込めてあります。このモジュール(デフォルトは 
+FML::Log::Print::Simple)は log_computer_output_engine 変数で指定可能で
+す。出力を切替えたい場合は、自分用のモジュールを作り、それを、この変数
+に指定してください。
+モジュールは
+FML::Log::Print::Simple
+を参考に、hack してみてください:)
+</para>
+
+</sect1>
+
+
+</chapter>