reconstruct/update considerations around DB.udb-base

6 files changed, 88 insertions, 75 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 72b29245..55ef7b0a 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.56 2003/05/12 10:16:38 fukachan Exp $
+$FML: book.sgml,v 1.57 2003/05/26 08:56:51 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -166,8 +166,7 @@ $FML: book.sgml,v 1.56 2003/05/12 10:16:38 fukachan Exp $
 	<!-- その他 -->
 	&chapter.io.abstraction;
 	&chapter.lock;
-	&chapter.db;
-	&chapter.db.thread;
+	&chapter.db.modules;
 	&chapter.dbms;
   </part>
 
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 4bfb331d..633c2df7 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.71 2003/05/12 10:16:39 fukachan Exp $
+	$FML: chapters.ent,v 1.72 2003/05/26 08:56:51 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -107,8 +107,8 @@
 <!-- う〜ん、分類は…？;-) -->
 <!entity chapter.directory        SYSTEM "internals/directory.sgml">
 <!entity chapter.db               SYSTEM "internals/db.sgml">
+<!entity chapter.db.modules       SYSTEM "internals/db_modules.sgml">
 <!entity chapter.dbms             SYSTEM "internals/dbms.sgml">
-<!entity chapter.db.thread        SYSTEM "internals/db.thread.sgml">
 <!entity chapter.hook             SYSTEM "internals/hook.sgml">
 <!entity chapter.policy           SYSTEM "policy.sgml">
 
diff --git a/fml/doc/ja/tutorial/internals/db.thread.sgml b/fml/doc/ja/tutorial/internals/db.thread.sgml
deleted file mode 100644
index 059a9824..00000000
--- a/fml/doc/ja/tutorial/internals/db.thread.sgml
+++ /dev/null
@@ -1,60 +0,0 @@
-<!--
-   $FML$
--->
-
-<chapter id="db.thread">
-	<title>
-	スレッド・データベース
-	</title>
-
-
-<para>
-スレッドのデータベースは
-「主に article_id か thread_id が primary key」
-です。
-<screen>
-$status		open / close
-$ml_name	elena
-article_id	100
-thread_id	elena/100
-$from		ヘッダの From: (めーる＠アドレスの形式)
-$sender		ヘッダの Sender: (めーる＠アドレスの形式)
-$x_sender	ヘッダの X-Sender: (めーる＠アドレスの形式)
-
-[thread]
-
-	aritcle_id	=>	thread_id
-
-[article]
-
-	thread_id	=>	article_ids
-
-	Example:	elena/100	=> 100 101 103 105
-
-[date]
-
-	aritcle_id	=>	unix_time
-
-[sender]
-
-	article_id	=>	from
-
-[message_id]
-
-	mesasge_id	=>	thread_id
-
-[status]
-
-	thread_id	=>	$status
-
-[index]
-
-	thread_id	=>	"$ml_name " *
-
-	Example: support/100 => support sales
-</screen>
-
-</para>
-
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/internals/db.sgml b/fml/doc/ja/tutorial/internals/db_modules.sgml
index 0eeaa829..7aa5d74d 100644
--- a/fml/doc/ja/tutorial/internals/db.sgml
+++ b/fml/doc/ja/tutorial/internals/db_modules.sgml
@@ -1,10 +1,55 @@
 <!--
-   $FML: db.sgml,v 1.6 2002/09/15 01:44:29 fukachan Exp $
+   $FML: db.sgml,v 1.7 2003/04/15 14:51:40 fukachan Exp $
 -->
 
-<chapter id="db">
+<chapter id="db.module">
 	<title>
-	データをどう保持するべきか？(データベースの扱い)
+	データベース関連モジュール
+	</title>
+
+
+<sect1 id="db.module.ovewview">
+	<title>
+	概要もしくは理想像
+	</title>
+
+<para>
+ＭＬドライバはメールのさまざまな要素をデータとして保存する必要がありま
+す。しかしながら、同じ要素でも、永続的に持つべき場合と、一定時間経過後
+に捨てて良い扱いの場合とがあります。
+</para>
+
+<para>
+前者の例はスレッドのデータです。一方、後者の例はフィルタシステムの持っ
+ている message-id cache などです。スレッドデータベースも同じく 
+message-id のデータを持っていますし、記事の分については重複しています。
+ですが、２つの有効期間は異なるため別々に取り扱う必要があります。
+</para>
+
+<para>
+とはいえ実際問題スレッド関係とそれ以外に集約できそうなので、
+各モジュールの理想的な関係は次のようになるのでしょう。
+<screen>
+モジュールＡ ---|ア|----- スレッド DB
+モジュールＢ ---|ダ|
+モジュールＣ ---|プ|
+モジュールＤ ---|タ|----- キャッシュ (有効期限つき)
+</screen>
+このスレッド DB は 
+<link linkend="threadtrack.db">
+Mail::Message::DB
+</link>
+のようなものとし、各種アダプタ層ががんばってほしい。
+また、キャッシュの方だが、現在では Tie::JournaledDir もしくは 
+File::CacheDir かのいづれかが使われることとなる。
+</para>
+
+</sect1>
+
+
+<sect1 id="db.module.persistent">
+	<title>
+	永続的なデータの保持
 	</title>
 
 <para>
@@ -61,8 +106,10 @@ File::CacheDir を使わないようにすることが可能でしょう。
 </para>
 </warning>
 
+</sect1>
+
 
-<sect1 id="db.Tie.JournaledFile">
+<sect1 id="db.module.Tie.JournaledFile">
 	<title>
 	Tie::JournaledFile クラス
 	</title>
@@ -133,9 +180,9 @@ first match と last match は切替えることができます。
 </sect1>
 
 
-<sect1 id="db.File.CacheDir">
+<sect1 id="db.module.File.CacheDir">
 	<title>
-	File::CacheDir
+	File::CacheDir クラス
 	</title>
 
 <para>
@@ -174,7 +221,7 @@ first match と last match は切替えることができます。
 
 
 
-<sect1 id="db.modules.usage">
+<sect1 id="db.module.usage">
 	<title>
 	モジュールの使い分け
 	</title>
diff --git a/fml/doc/ja/tutorial/internals/dbms.sgml b/fml/doc/ja/tutorial/internals/dbms.sgml
index 881fcfea..b069ee07 100644
--- a/fml/doc/ja/tutorial/internals/dbms.sgml
+++ b/fml/doc/ja/tutorial/internals/dbms.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: dbms.sgml,v 1.3 2002/07/06 14:55:18 fukachan Exp $
+   $FML: dbms.sgml,v 1.4 2003/04/15 14:51:40 fukachan Exp $
 -->
 
 <chapter id="dbms">
@@ -7,6 +7,12 @@
 	データベース管理システム
 	</title>
 
+
+<sect1 id="dbms.overview">
+	<title>
+	概要
+	</title>
+
 <para>
 DBMS との通信は
 <link linkend="module.io.adapter">
@@ -21,5 +27,24 @@ IO::Adapter
 IO::Adapter の前段階のプログラムが頑張る必要があります。
 </para>
 
+</sect1>
+
+
+<sect1 id="dbms.todo">
+	<title>
+	TODO
+	</title>
+
+<para>
+メソッドが必要最少限になっているかは考えた方がいい。
+けれど、
+<link linkend="module.io.adapter">
+IO::Adapter 
+</link>
+のメソッド準拠ではあるので、とりあえずいいのかな。
+</para>
+
+</sect1>
+
 
 </chapter>
diff --git a/fml/doc/ja/tutorial/threadtrack/db.sgml b/fml/doc/ja/tutorial/threadtrack/db.sgml
index e97e2241..48e7dfcf 100644
--- a/fml/doc/ja/tutorial/threadtrack/db.sgml
+++ b/fml/doc/ja/tutorial/threadtrack/db.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: db.sgml,v 1.1 2002/12/30 07:38:08 fukachan Exp $
+   $FML: db.sgml,v 1.2 2003/04/15 14:51:44 fukachan Exp $
 -->
 
 <sect1 id="threadtrack.db">
@@ -45,7 +45,9 @@ x_sender	ヘッダの X-Sender: (めーる＠アドレスの形式)
 </para>
 
 <para>
-いずれの .db も article_id か thread_id が primary key です。
+スレッドのデータベースは
+「主に article_id か thread_id が primary key」
+です。
 具体的に書くと以下のようになります。
 <screen>
 [thread .db]