clean up documents hierarchy.

remove {index,pointer}.ja.html in each directory which is obsolete.
merge documents to under fml/doc/ja/ if apporoviate.
move variable list to Documentation/ja/etc/

9 files changed, 279 insertions, 6 deletions

diff --git a/fml/doc/ja/tutorial/.cvsignore b/fml/doc/ja/tutorial/.cvsignore
index e855c1c8..c9690774 100644
--- a/fml/doc/ja/tutorial/.cvsignore
+++ b/fml/doc/ja/tutorial/.cvsignore
@@ -1,2 +1,3 @@
 fml-devel.fot
 fml-devel
+book
diff --git a/fml/doc/ja/tutorial/Makefile b/fml/doc/ja/tutorial/Makefile
index 29e51126..1e0f7172 100644
--- a/fml/doc/ja/tutorial/Makefile
+++ b/fml/doc/ja/tutorial/Makefile
@@ -1,5 +1,5 @@
 #
-# $FML: Makefile,v 1.8 2001/04/24 11:40:37 fukachan Exp $
+# $FML: Makefile,v 1.9 2001/04/28 10:01:47 fukachan Exp $
 #
 
 # targets
@@ -11,7 +11,7 @@ ID          = techtips.html
 ### CONFIGURATIONS
 ###
 
-SOURCE      = fml-devel
+SOURCE      = book
 BOOK        = tutorial
 BOOK_ID     = fml-devel
 TARGET_DIR  = ../../../../Documentation/ja/$(BOOK)
diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
new file mode 100644
index 00000000..506fa306
--- /dev/null
+++ b/fml/doc/ja/tutorial/book.sgml
@@ -0,0 +1,89 @@
+<!--
+This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
+to generate various output formats.
+
+$FML: fml-devel.sgml,v 1.16 2001/04/28 09:33:40 fukachan Exp $
+-->
+
+<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
+	<!entity % include SYSTEM "include.sgml"> %include;
+]>
+
+<book id="fml-devel">
+
+  &bookinfo;
+
+  &preface; 
+
+  <toc></toc>
+
+  <part>
+	<title> 基本的な使い方 </title>
+	<partintro>
+	<para>
+	本パートは初心者向けの設定ガイドを目指しています。
+	内容は基本的なデザイン思想や設定の仕方についてです。
+	</para>
+	<para>
+	なお、メーリングリストの仕組みなどの、
+	より基本的な内容については
+	&fmlbible; 
+	や
+	&www.fml.org;
+	などを参照して下さい。
+	</para>
+	</partintro>
+
+	<!-- 以下、各章が並ぶ -->
+	&intro;
+	&overview;
+	&download;
+	&install;
+	&available;
+  </part>
+
+
+  <part>
+	<title> 技術的解説 </title>
+	<partintro>
+	<para>
+	本パートでは…
+	</para>
+	</partintro>
+
+	<!-- 以下、各章が並ぶ -->
+	&design;
+	&bootloader;
+	&programs;
+	&fmlcommands;
+        &delivery;
+  </part>
+
+
+  <part>
+	<title> 開発者向けの話題 </title>
+	<partintro>
+	<para>
+	本パートでは開発者向けの内容についてまとめます。
+	</para>
+	</partintro>
+
+	<!-- 以下、各章が並ぶ -->
+	&cvstree;
+	&programingstyle; 
+	&modules;
+  </part>
+
+
+  <!-- 
+	***** ここから後は付録 *****
+  -->
+  <part>
+	<title> 付録 </title>
+	&glossary;
+	&docbook;
+	&cvstags;
+  </part>
+
+</book>
+
diff --git a/fml/doc/ja/tutorial/commands.sgml b/fml/doc/ja/tutorial/commands.sgml
index 9427e0bd..7c0b2e52 100644
--- a/fml/doc/ja/tutorial/commands.sgml
+++ b/fml/doc/ja/tutorial/commands.sgml
@@ -1,15 +1,16 @@
 <!--
-	$FML: fmlcommands.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+	$FML: commands.sgml,v 1.3 2001/04/28 09:33:39 fukachan Exp $
 -->
 
 <chapter id="fmlcommands">
 
 <title>	fml をメールで操作する </title>
 
+<para>
 fml にメールでコマンドを送り込むことで、fml に特定の処理をしてもらうこ
 とができます。例えば、メンバーの登録、削除や、過去の記事を取り寄せるな
 どの処理です。
-
+</para>
 
 <sect1>
    <title> コマンドの拡張の仕方の例 </title>
diff --git a/fml/doc/ja/tutorial/delivery.sgml b/fml/doc/ja/tutorial/delivery.sgml
new file mode 100644
index 00000000..242c8f2a
--- /dev/null
+++ b/fml/doc/ja/tutorial/delivery.sgml
@@ -0,0 +1,56 @@
+<!--
+    $FML$
+-->
+
+<chapter id="delivery">
+
+   <TITLE> メールの配送 </TITLE>
+
+<sect1 id="fml5-delivery">
+
+   <title> fml5 のメール配送システムについて 
+           (fml4 と fml5 の相違点)
+   </title>
+
+<para>
+fml5 の最大の目的の一つは、メンバーリストの取得と操作の統合と抽象化です。
+配送には抽象化された Mail::Delivery クラスを次のように使います。
+</para>
+
+<para>
+Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ
+イスを提供します。
+
+<screen>
+    use Mail::Delivery::SMTP;
+    my $service = new Mail::Delivery::SMTP;
+    if ($service->error) { Log($service->error); return;}
+
+    $service->deliver(
+                      {
+                          mta             => '127.0.0.1:25',
+
+                          smtp_sender     => 'rudo@nuinui.net',
+                          recipient_maps  => $recipient_maps,
+                          recipient_limit => 1000,
+
+                          header          => $header_object,
+                          body            => $body_object,
+                      });
+</screen>
+
+ここで $header_object はヘッダで、FML::Header オブジェクトです。
+そして $body_oject   はメール本文で、Mail::Message オブジェクトです。
+</para>
+
+<para>
+ここで、Delivery は
+SMTP
+ESMTP
+LMTP
+などへのインターフェイスです。
+</para>
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml
new file mode 100644
index 00000000..242c8f2a
--- /dev/null
+++ b/fml/doc/ja/tutorial/delivery/chapter.sgml
@@ -0,0 +1,56 @@
+<!--
+    $FML$
+-->
+
+<chapter id="delivery">
+
+   <TITLE> メールの配送 </TITLE>
+
+<sect1 id="fml5-delivery">
+
+   <title> fml5 のメール配送システムについて 
+           (fml4 と fml5 の相違点)
+   </title>
+
+<para>
+fml5 の最大の目的の一つは、メンバーリストの取得と操作の統合と抽象化です。
+配送には抽象化された Mail::Delivery クラスを次のように使います。
+</para>
+
+<para>
+Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ
+イスを提供します。
+
+<screen>
+    use Mail::Delivery::SMTP;
+    my $service = new Mail::Delivery::SMTP;
+    if ($service->error) { Log($service->error); return;}
+
+    $service->deliver(
+                      {
+                          mta             => '127.0.0.1:25',
+
+                          smtp_sender     => 'rudo@nuinui.net',
+                          recipient_maps  => $recipient_maps,
+                          recipient_limit => 1000,
+
+                          header          => $header_object,
+                          body            => $body_object,
+                      });
+</screen>
+
+ここで $header_object はヘッダで、FML::Header オブジェクトです。
+そして $body_oject   はメール本文で、Mail::Message オブジェクトです。
+</para>
+
+<para>
+ここで、Delivery は
+SMTP
+ESMTP
+LMTP
+などへのインターフェイスです。
+</para>
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml
index 01593c60..57dd038f 100644
--- a/fml/doc/ja/tutorial/fml-devel.sgml
+++ b/fml/doc/ja/tutorial/fml-devel.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: fml-devel.sgml,v 1.15 2001/04/26 11:02:39 fukachan Exp $
+$FML: fml-devel.sgml,v 1.16 2001/04/28 09:33:40 fukachan Exp $
 -->
 
 <!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
@@ -56,6 +56,7 @@ $FML: fml-devel.sgml,v 1.15 2001/04/26 11:02:39 fukachan Exp $
 	&bootloader;
 	&programs;
 	&fmlcommands;
+        &delivery;
   </part>
 
 
diff --git a/fml/doc/ja/tutorial/include.sgml b/fml/doc/ja/tutorial/include.sgml
index 7a338a77..340c04f6 100644
--- a/fml/doc/ja/tutorial/include.sgml
+++ b/fml/doc/ja/tutorial/include.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: include.sgml,v 1.15 2001/04/26 11:02:39 fukachan Exp $
+	$FML: include.sgml,v 1.16 2001/04/28 09:33:40 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -27,6 +27,11 @@
 <!entity reference       SYSTEM "reference.sgml">
 
 
+
+<!entity delivery          SYSTEM "delivery.sgml">
+<!entity modules          SYSTEM "modules.sgml">
+
+
 <!entity appendix SYSTEM "appendix.sgml">
 <!entity glossary SYSTEM "glossary.sgml">
 <!entity cvstree  SYSTEM "cvstree.sgml">
diff --git a/fml/doc/ja/tutorial/modules.sgml b/fml/doc/ja/tutorial/modules.sgml
new file mode 100644
index 00000000..bb9602c2
--- /dev/null
+++ b/fml/doc/ja/tutorial/modules.sgml
@@ -0,0 +1,64 @@
+<!--
+    $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>