summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial
diff options
context:
space:
mode:
authorfukachan <fukachan>2001-08-26 05:55:51 +0000
committerfukachan <fukachan>2001-08-26 05:55:51 +0000
commit9f6d8850a1bac24b663bacae7a4df87ea8da936d (patch)
tree319ba2596854f51c9934de8e25e5b4bc5c3aa049 /fml/doc/ja/tutorial
parent7b5715dcff778b1aa3886889a788539fbe0daa7d (diff)
downloadfml8-9f6d8850a1bac24b663bacae7a4df87ea8da936d.tar.gz
fml8-9f6d8850a1bac24b663bacae7a4df87ea8da936d.tar.bz2
fml8-9f6d8850a1bac24b663bacae7a4df87ea8da936d.zip
clean up
Diffstat (limited to 'fml/doc/ja/tutorial')
-rw-r--r--fml/doc/ja/tutorial/commands.sgml38
-rw-r--r--fml/doc/ja/tutorial/delivery/chapter.sgml43
-rw-r--r--fml/doc/ja/tutorial/delivery/reply.sgml19
-rw-r--r--fml/doc/ja/tutorial/preface.sgml33
4 files changed, 89 insertions, 44 deletions
diff --git a/fml/doc/ja/tutorial/commands.sgml b/fml/doc/ja/tutorial/commands.sgml
index 7c0b2e52..d8fd3e19 100644
--- a/fml/doc/ja/tutorial/commands.sgml
+++ b/fml/doc/ja/tutorial/commands.sgml
@@ -1,17 +1,25 @@
<!--
- $FML: commands.sgml,v 1.3 2001/04/28 09:33:39 fukachan Exp $
+ $FML: commands.sgml,v 1.4 2001/04/30 10:21:43 fukachan Exp $
-->
-<chapter id="fmlcommands">
+<chapter id="fml.command.op">
<title> fml をメールで操作する </title>
<para>
-fml にメールでコマンドを送り込むことで、fml に特定の処理をしてもらうこ
-とができます。例えば、メンバーの登録、削除や、過去の記事を取り寄せるな
-どの処理です。
+fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
+もらうことができます。例えば、メンバーの登録、削除や、過去の記事を取り
+寄せるなどの処理です。
</para>
+<para>
+メールによるコマンド処理
+makefml によるコマンド処理
+CGI でのコマンド処理
+すべてが同じ FML::Command:: クラスのモジュールを使うことにします。
+</para>
+
+
<sect1>
<title> コマンドの拡張の仕方の例 </title>
@@ -20,18 +28,20 @@ fml にメールでコマンドを送り込むことで、fml に特定の処理をしてもらうこ
<title> 独自コマンドを作る。 </title>
<para>
+ fml 5.0 では、
例えばコマンド uja を作りたいなら、FML::Command をぱくって
-
- /usr/local/lib/fml/site_local/FML/Command/uja.pm
-
- というファイルを置けば OK (いいのか、それで?)。
+<screen>
+/usr/local/lib/fml/site_local/FML/Command/uja.pm
+</screen>
+ というファイルを置けば OK にしようとしています。
</para>
- <para>
- いや、うそかも… 許可するコマンドリストに追加して始めて
- 有効になるようにしないといけないと思う。
- </para>
- </sect2>
+<para>
+これだけではだめで、許可するコマンドリストに追加して始めて有効になるよ
+うにしないといけないでしょう。
+</para>
+
+</sect2>
</sect1>
diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml
index 6b4c81bf..5968573f 100644
--- a/fml/doc/ja/tutorial/delivery/chapter.sgml
+++ b/fml/doc/ja/tutorial/delivery/chapter.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: chapter.sgml,v 1.1 2001/04/30 10:21:43 fukachan Exp $
+ $FML: chapter.sgml,v 1.2 2001/05/17 04:25:32 fukachan Exp $
-->
<chapter id="delivery">
@@ -20,7 +20,17 @@ fml5 の最大の目的の一つは、メンバーリストの取得と操作の統合と抽象化です。
<para>
Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ
イスを提供します。
+つまり
+Mail::Delivery は
+Mail::Delivery 以下の派生クラス
+SMTP
+ESMTP
+LMTP
+へのインターフェイスを提供するアダプター層です。
+</para>
+<para>
+例えば次のように使います。
<screen>
use Mail::Delivery::SMTP;
my $service = new Mail::Delivery::SMTP;
@@ -37,23 +47,36 @@ Mail::Delivery::* に属するクラスは SMTP および LMTP 配送へのインターフェ
mesage => $message
});
</screen>
-
ここで $message は Mail::Message オブジェクトです。
-このオブジェクトは
+</para>
+
+</sect1>
+
+
+<sect1>
+ <title>
+ Mail::Message オブジェクト
+ </title>
+
+<para>
+このオブジェクトはメールを解析し、
<screen>
header -> body
header -> preamble -> part1 -> part2 -> trailor (multipart)
</screen>
-のようにオブジェクトが数珠つなぎになっているオブジェクトです。
+のようにオブジェクトが数珠つなぎのようなデータ構造を作ります。
</para>
<para>
-Mail::Delivery は
-Mail::Delivery 以下の派生クラス
-SMTP
-ESMTP
-LMTP
-へのインターフェイスを提供するアダプター層です。
+Mail::Message のクラスは
+このようなデータ構造に対して、さまざまなオペレーションを提供します。
+</para>
+
+<para>
+参照:
+<ulink url="../../en/modules/Mail/Message.txt">
+Mail::Message モジュールのマニュアル
+</ulink>
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/delivery/reply.sgml b/fml/doc/ja/tutorial/delivery/reply.sgml
index c9145f25..b0f38ab1 100644
--- a/fml/doc/ja/tutorial/delivery/reply.sgml
+++ b/fml/doc/ja/tutorial/delivery/reply.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: reply.sgml,v 1.1 2001/05/17 00:47:35 fukachan Exp $
+ $FML: reply.sgml,v 1.2 2001/05/18 10:53:03 fukachan Exp $
-->
<chapter id="reply">
@@ -68,17 +68,14 @@ new/ から active/ に移動されます。
</title>
<para>
-sender にあるメッセージを送り返したい場合は、次のようにします。
+あるメッセージを送り返したい場合は、次のようにします。
<screen>
$curproc->reply_message( "you are not a ML member." );
</screen>
+この場合の受信者はコマンドの結果などを受けとる人、
+fml にリクエストをした人です。
</para>
-<warning>
-<para>
-うーん、言語の変換はどこでどう指示するべき?
-</para>
-</warning>
<para>
ファイルを送りたい場合や画像を送りたい場合は次のようにします。
@@ -99,6 +96,14 @@ $curproc->reply_message( {
</screen>
</para>
+
+<warning>
+<para>
+うーん、言語の変換はどこでどう指示するべきでしょうか?
+</para>
+</warning>
+
+
</sect1>
</chapter>
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
index c46080fd..4c6aa386 100644
--- a/fml/doc/ja/tutorial/preface.sgml
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -1,10 +1,12 @@
<!--
- $FML: preface.sgml,v 1.6 2001/04/26 09:27:45 fukachan Exp $
+ $FML: preface.sgml,v 1.7 2001/05/10 03:12:10 fukachan Exp $
-->
<preface>
+ <title>
+ 前書き
+ </title>
-<title> 前書き </title>
<!-- ======================================================== -->
<sect1>
@@ -12,21 +14,29 @@
<title> はるかなる fml 5.0 への道 </title>
<para>
-fml 5.0 とは fml 4.0 を一から書き直す次世代 fml プロジェクトの総称です。
+fml 5.0 とは fml 4.0 を一から書き直す次世代 fml プロジェクトの総称
+ <footnote>
+ <para>
+ ざっくりとしたイメージしては
+ 4.0 と 5.0 の違いは
+ sendmail と postfix のような関係といえるでしょう。
+ </para>
+ </footnote>
+です。
fml 4.0 までに至る約 10 年の経験を再実装する試みといえます。
これには何年もの歳月がかかるでしょう。
</para>
<warning>
<para>
- 実運用には fml-devel を使わずに 4.0 stable を使って下さい。
- fml-devel は開発用で、 fml-current ですらありません。
+実運用には fml-devel を使わずに 4.0 stable を使って下さい。
+fml-devel は開発用で、 fml-current ですらありません。
</para>
</warning>
<para>
fml 5.0 への道(はるかなる道)について、
-現在次のように構想しています。
+現在は次のような構想を持っています。
基本的な考え方は fml 4.0 の”機能”を再構想/再実装することです。
</para>
@@ -67,21 +77,17 @@ fml 5.0 への道(はるかなる道)について、
リリースなどではありません。これは、あくまでもアイデアを表現するための
ものですが、配送プログラムとしては十分動きます。fml-devel MLをはじめ
として、いくつか運用テストに入っているものがあります。
+また、チケットシステムも同様に実運用ベースでテストされています。
</para>
<para>
最初に実装するのは
<emphasis>
-fml 1.2 相当の最低限の機能
+fml 1.2 相当の最低限の機能に makefml が加わったもの
</emphasis>
だろうと考えています。
</para>
-<para>
-ざっくりとしたイメージは sendmail と postfix のような違いになるだろう
-と個人的には思っています。
-</para>
-
</sect1>
@@ -115,7 +121,8 @@ fml 5.0 のアルファ版のアルファ版のアルファ版
プロトタイプ
とでもいうべきものです。ですが、すでに動く実装例をダウンロードできます
し、fml 1.2 相当の機能を使うこともできます。しかしながら、変数名もアー
-キテクチャアも本決まりではないので、将来変わる可能性があります。
+キテクチャア
+も本決まりではないので、将来変わる可能性があります。
</para>
<para>