how to store data persistently

4 files changed, 91 insertions, 68 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 98309b4a..6d304491 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.10 2001/05/17 04:00:43 fukachan Exp $
+$FML: book.sgml,v 1.11 2001/06/10 10:22:44 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -73,7 +73,7 @@ $FML: book.sgml,v 1.10 2001/05/17 04:00:43 fukachan Exp $
 	&chapter.cvstree;
 	&chapter.programingstyle; 
         &chapter.message;
-	&chapter.modules;
+	&chapter.db;
 	&chapter.nl;
   </part>
 
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 3073f4ec..7014f256 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.11 2001/06/10 10:22:44 fukachan Exp $
+	$FML: chapters.ent,v 1.12 2001/06/10 12:58:31 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -30,7 +30,7 @@
 
 <!-- う〜ん、分類は…？;-) -->
 <!entity chapter.fmlcommands SYSTEM "commands.sgml">
-<!entity chapter.modules     SYSTEM "modules.sgml">
+<!entity chapter.db          SYSTEM "internals/db.sgml">
 
 
 <!-- 配送 -->
diff --git a/fml/doc/ja/tutorial/internals/db.sgml b/fml/doc/ja/tutorial/internals/db.sgml
new file mode 100644
index 00000000..f866c4f7
--- /dev/null
+++ b/fml/doc/ja/tutorial/internals/db.sgml
@@ -0,0 +1,87 @@
+<!--
+   $FML$
+-->
+
+<chapter id="db">
+	<title>
+	データベースの扱い
+	</title>
+
+<para>
+永続的にデータを保持する方法はいくつかあります。
+LRU な何かモジュールを使っても良いのですが、
+大げさで、いまひとつしっくりこない気がします。
+</para>
+
+<para>
+FML では、expire の仕方に応じて、
+代表的な２つのクラスを用意しています。
+</para>
+
+
+
+<sect1 id="db.Tie.JournaledFile">
+	<title>
+	Tie::JournaledFile クラス
+	</title>
+
+<para>
+一つの考えは、一つのファイルに append していくもの。
+このために
+Tie::JournaledFile
+クラスが用意されています。
+これは、
+データを蓄えるために用いています。
+つまり、追加もするし、参照もしたい場合ですが、
+追加しかしません。
+必要な時には過去のログを追跡できます。
+値は追加された値を last match で取り出します。
+</para>
+
+</sect1>
+
+
+<sect1 id="db.File.CacheDir">
+	<title>
+	File::CacheDir
+	</title>
+
+<para>
+これは、あるディレクトリ(例: db/)に複数のファイルとして蓄える。
+db/ には 1 〜 100 のファイルがつくられ、順番に使われる。
+ぐるぐる回って使われ、上書きされていく。
+</para>
+
+
+<para>
+主に上限サイズを設けたログを蓄えたい場合に用いる。
+</para>
+
+
+<para>
+あるディレクトリに複数のファイルとして蓄えるが、
+古いものを expire していくことが可能なもの。
+db/ に YYYYMM 形式のファイル名でデータを蓄え、
+古いものは随時消去する。
+</para>
+
+
+<para>
+データを蓄えるために用いている。つまり、追加もするし、
+参照もしたい場合に使いますが、
+いつのまにか古いデータは消えていきます。
+</para>
+
+
+<warning>
+<para>
+旧 RingBuffer, File::CacheDir に統合されました。
+</para>
+</warning>
+
+</sect1>
+
+
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/modules.sgml b/fml/doc/ja/tutorial/modules.sgml
deleted file mode 100644
index bb9602c2..00000000
--- a/fml/doc/ja/tutorial/modules.sgml
+++ /dev/null
@@ -1,64 +0,0 @@
-<!--
-    $FML$
--->
-
-<chapter id="modules">
-
-   <title> モジュールについて２、３のメモ </title>
-
-
-<sect1 id="File">
-
-    <title>
-    File::* クラス
-    </title>
-
-<para>
-persistent なデータの保持の方法はいくつかある。
-LRU な何かモジュールを使っても良いが、
-大げさで、いまひとつしっくりこない。
-</para>
-
-<para>
-一つの考えは、一つのファイルに append していくもの。
-Log Structured File スタイル？
-これは、
-データを蓄えるために用いている。つまり、追加もするし、
-参照もしたい場合。
-</para>
-
-<para>
-File::CacheDir (旧 RingBuffer, File::CacheDir に統合された)
-もある。
-</para>
-
-<para>
-これは、あるディレクトリ(例: db/)に複数のファイルとして蓄える。
-db/ には 1 〜 100 のファイルがつくられ、順番に使われる。
-ぐるぐる回って使われ、上書きされていく。
-</para>
-
-<para>
-主に上限サイズを設けたログを蓄えたい場合に用いる。
-</para>
-
-<para>
-File::CacheDir
-</para>
-
-<para>
-あるディレクトリに複数のファイルとして蓄えるが、
-古いものを expire していくことが可能なもの。
-db/ に YYYYMM 形式のファイル名でデータを蓄え、
-古いものは随時消去する。
-</para>
-
-<para>
-データを蓄えるために用いている。つまり、追加もするし、
-参照もしたい場合。
-</para>
-
-</sect1>
-
-
-</chapter>