From 28dfaebfa4d77427a745046ad1b56a4d256f38aa Mon Sep 17 00:00:00 2001 From: fukachan Date: Mon, 30 Apr 2001 10:21:41 +0000 Subject: 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/ --- fml/doc/ja/tutorial/.cvsignore | 1 + fml/doc/ja/tutorial/Makefile | 4 +- fml/doc/ja/tutorial/book.sgml | 89 +++++++++++++++++++++++++++++++ fml/doc/ja/tutorial/commands.sgml | 5 +- fml/doc/ja/tutorial/delivery.sgml | 56 +++++++++++++++++++ fml/doc/ja/tutorial/delivery/chapter.sgml | 56 +++++++++++++++++++ fml/doc/ja/tutorial/fml-devel.sgml | 3 +- fml/doc/ja/tutorial/include.sgml | 7 ++- fml/doc/ja/tutorial/modules.sgml | 64 ++++++++++++++++++++++ 9 files changed, 279 insertions(+), 6 deletions(-) create mode 100644 fml/doc/ja/tutorial/book.sgml create mode 100644 fml/doc/ja/tutorial/delivery.sgml create mode 100644 fml/doc/ja/tutorial/delivery/chapter.sgml create mode 100644 fml/doc/ja/tutorial/modules.sgml (limited to 'fml/doc/ja/tutorial') 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 @@ + + + %include; +]> + + + + &bookinfo; + + &preface; + + + + + 基本的な使い方 + + + 本パートは初心者向けの設定ガイドを目指しています。 + 内容は基本的なデザイン思想や設定の仕方についてです。 + + + なお、メーリングリストの仕組みなどの、 + より基本的な内容については + &fmlbible; + や + &www.fml.org; + などを参照して下さい。 + + + + + &intro; + &overview; + &download; + &install; + &available; + + + + + 技術的解説 + + + 本パートでは… + + + + + &design; + &bootloader; + &programs; + &fmlcommands; + &delivery; + + + + + 開発者向けの話題 + + + 本パートでは開発者向けの内容についてまとめます。 + + + + + &cvstree; + &programingstyle; + &modules; + + + + + + 付録 + &glossary; + &docbook; + &cvstags; + + + + 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 をメールで操作する + fml にメールでコマンドを送り込むことで、fml に特定の処理をしてもらうこ とができます。例えば、メンバーの登録、削除や、過去の記事を取り寄せるな どの処理です。 - + コマンドの拡張の仕方の例 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 @@ + + + + + メールの配送 + + + + fml5 のメール配送システムについて + (fml4 と fml5 の相違点) + + + +fml5 の最大の目的の一つは、メンバーリストの取得と操作の統合と抽象化です。 +配送には抽象化された Mail::Delivery クラスを次のように使います。 + + + +Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ +イスを提供します。 + + + 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, + }); + + +ここで $header_object はヘッダで、FML::Header オブジェクトです。 +そして $body_oject はメール本文で、Mail::Message オブジェクトです。 + + + +ここで、Delivery は +SMTP +ESMTP +LMTP +などへのインターフェイスです。 + + + + + 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 @@ + + + + + メールの配送 + + + + fml5 のメール配送システムについて + (fml4 と fml5 の相違点) + + + +fml5 の最大の目的の一つは、メンバーリストの取得と操作の統合と抽象化です。 +配送には抽象化された Mail::Delivery クラスを次のように使います。 + + + +Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ +イスを提供します。 + + + 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, + }); + + +ここで $header_object はヘッダで、FML::Header オブジェクトです。 +そして $body_oject はメール本文で、Mail::Message オブジェクトです。 + + + +ここで、Delivery は +SMTP +ESMTP +LMTP +などへのインターフェイスです。 + + + + + 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 $ --> 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 @@ @@ -27,6 +27,11 @@ + + + + + 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 @@ + + + + + モジュールについて２、３のメモ + + + + + + File::* クラス + + + +persistent なデータの保持の方法はいくつかある。 +LRU な何かモジュールを使っても良いが、 +大げさで、いまひとつしっくりこない。 + + + +一つの考えは、一つのファイルに append していくもの。 +Log Structured File スタイル？ +これは、 +データを蓄えるために用いている。つまり、追加もするし、 +参照もしたい場合。 + + + +File::CacheDir (旧 RingBuffer, File::CacheDir に統合された) +もある。 + + + +これは、あるディレクトリ(例: db/)に複数のファイルとして蓄える。 +db/ には 1 〜 100 のファイルがつくられ、順番に使われる。 +ぐるぐる回って使われ、上書きされていく。 + + + +主に上限サイズを設けたログを蓄えたい場合に用いる。 + + + +File::CacheDir + + + +あるディレクトリに複数のファイルとして蓄えるが、 +古いものを expire していくことが可能なもの。 +db/ に YYYYMM 形式のファイル名でデータを蓄え、 +古いものは随時消去する。 + + + +データを蓄えるために用いている。つまり、追加もするし、 +参照もしたい場合。 + + + + + + -- cgit v1.2.1