summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial
diff options
context:
space:
mode:
authorfukachan <fukachan>2001-10-13 08:47:54 +0000
committerfukachan <fukachan>2001-10-13 08:47:54 +0000
commite661c9ce6dbc5b357f32ad7225b4f6d0926c9173 (patch)
treec3835d9a67c7ea8095acce01aef831df696786dd /fml/doc/ja/tutorial
parent9ee1172e9223ba52d644fc6b7cd5be5d3280326a (diff)
downloadfml8-e661c9ce6dbc5b357f32ad7225b4f6d0926c9173.tar.gz
fml8-e661c9ce6dbc5b357f32ad7225b4f6d0926c9173.tar.bz2
fml8-e661c9ce6dbc5b357f32ad7225b4f6d0926c9173.zip
updated to catch up current
Diffstat (limited to 'fml/doc/ja/tutorial')
-rw-r--r--fml/doc/ja/tutorial/book.sgml7
-rw-r--r--fml/doc/ja/tutorial/command/chapter.sgml85
-rw-r--r--fml/doc/ja/tutorial/command/extension.sgml32
-rw-r--r--fml/doc/ja/tutorial/delivery/chapter.sgml25
-rw-r--r--fml/doc/ja/tutorial/delivery/reply.sgml44
-rw-r--r--fml/doc/ja/tutorial/devel/cvstree.sgml9
-rw-r--r--fml/doc/ja/tutorial/include/chapters.ent9
-rw-r--r--fml/doc/ja/tutorial/install/chapter.sgml40
-rw-r--r--fml/doc/ja/tutorial/internals/dbms.sgml13
-rw-r--r--fml/doc/ja/tutorial/internals/design.sgml7
-rw-r--r--fml/doc/ja/tutorial/internals/errormessage.sgml200
-rw-r--r--fml/doc/ja/tutorial/internals/ioadapter.sgml77
-rw-r--r--fml/doc/ja/tutorial/internals/message.sgml26
-rw-r--r--fml/doc/ja/tutorial/internals/nativelanguage.sgml13
-rw-r--r--fml/doc/ja/tutorial/internals/style.sgml10
-rw-r--r--fml/doc/ja/tutorial/module/Mail::Message.sgml15
-rw-r--r--fml/doc/ja/tutorial/overview/available.sgml7
-rw-r--r--fml/doc/ja/tutorial/overview/chapter.sgml6
-rw-r--r--fml/doc/ja/tutorial/overview/download.sgml13
-rw-r--r--fml/doc/ja/tutorial/programs/makefml.sgml8
20 files changed, 264 insertions, 382 deletions
diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index c6520ac2..80b0bed3 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.15 2001/09/30 23:08:23 fukachan Exp $
+$FML: book.sgml,v 1.16 2001/10/12 11:14:18 fukachan Exp $
-->
<!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -54,9 +54,11 @@ $FML: book.sgml,v 1.15 2001/09/30 23:08:23 fukachan Exp $
&chapter.bootloader;
&chapter.programs;
&chapter.config.cf;
- &chapter.fmlcommand;
+
+ <!-- 記事の配送とコマンドの処理 -->
&chapter.delivery;
&chapter.replybyfml;
+ &chapter.fmlcommand;
</part>
@@ -73,6 +75,7 @@ $FML: book.sgml,v 1.15 2001/09/30 23:08:23 fukachan Exp $
&chapter.cvstree;
&chapter.programingstyle;
&chapter.message;
+ &chapter.message.nl;
&chapter.db;
&chapter.dbms;
&chapter.nl;
diff --git a/fml/doc/ja/tutorial/command/chapter.sgml b/fml/doc/ja/tutorial/command/chapter.sgml
index 42e6e098..41e161f4 100644
--- a/fml/doc/ja/tutorial/command/chapter.sgml
+++ b/fml/doc/ja/tutorial/command/chapter.sgml
@@ -1,10 +1,10 @@
<!--
- $FML: chapter.sgml,v 1.1.1.1 2001/10/12 11:00:20 fukachan Exp $
+ $FML: chapter.sgml,v 1.2 2001/10/12 11:14:19 fukachan Exp $
-->
<chapter id="fml.command.op">
<title>
- fml をメールで操作する
+ コマンド: fml をメールで操作する
</title>
<para>
@@ -14,10 +14,14 @@ fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
</para>
<para>
+fml 5.0 では
+<screen>
メールによるコマンド処理
makefml によるコマンド処理
CGI でのコマンド処理
-すべてが同じ FML::Command:: クラスのモジュールを使うことにします。
+</screen>
+これらすべての機能が FML::Command:: クラスのモジュールを使うように
+設計されています。
</para>
@@ -27,7 +31,7 @@ CGI でのコマンド処理
</title>
<para>
-FML::Command:: クラスの再構成
+FML::Command:: クラスは以下のような構成になっています。
<screen>
FML::Command.pm FML::Command クラス以下への入口
FML::Command::ACL ACL
@@ -35,41 +39,65 @@ FML::Command::Utils よもやまの定義
FML::Command::User ユーザ用コマンド群
FML::Command::Admin ユーザ用コマンド群
</screen>
+例えば、(メールでの)ユーザ用のコマンドの場合
+FML::Command.pm を経由して
+FML::Command::User::コマンド.pm
+モジュールを使うことになります。
</para>
+<sect2>
+ <title> (メールでの)一般ユーザ用コマンド </title>
<para>
-例えば、ユーザ用のコマンドの場合
-FML::Command.pm を経由して
+FML::Process::Command.pm から
+FML::Command.pm 経由で
FML::Command::User::コマンド.pm
-モジュールを使うことになります。
+を用います。
</para>
-</sect1>
+<para>
+最終的に
+FML::Command::Admin::コマンド.pm
+を使うモジュールもあります。
+例えば登録と削除の実作業は
+FML::Command::Admin::コマンド.pm
+が行なっています。この場合
+FML::Command::User::コマンド.pm
+のコマンドは confirm を行なうための wrapper です。
+</para>
+</sect2>
+<sect2>
+ <title> (メールでの) adminコマンド </title>
-&sect.command.internal;
+<para>
+FML::Process::Command.pm から
+FML::Command.pm 経由で
+FML::Command::Admin::コマンド.pm
+を用います。
+</para>
+</sect2>
-<sect1 id="fml.command.hack.example0">
- <title> コマンドの拡張の仕方の例 </title>
+<sect2>
+ <title> makefml のコマンド </title>
+<para>
+FML::Process::Configure.pm から
+FML::Command.pm 経由で
+FML::Command::Admin::コマンド.pm
+を用います。
+</para>
- <sect2>
- <title> 独自コマンドを作る。 </title>
+</sect2>
- <para>
- fml 5.0 では、
- 例えばユーザ向けのコマンド uja を作りたい場合、
- FML::Command 以下から適当に cut & paste して
-<screen>
-/usr/local/lib/fml/site_local/FML/Command/User/uja.pm
-</screen>
- というファイルを置けば OK にしようとしています。
- </para>
+<sect2>
+ <title> CGI (予定) </title>
<para>
-これだけではだめで、許可するコマンドリストに追加して始めて有効になるよ
-うにしないといけないでしょう。
+FML::Process::CGI.pm から
+FML::Command.pm 経由で
+FML::Command::Admin::コマンド.pm
+を用います(予定)。
</para>
</sect2>
@@ -77,4 +105,13 @@ FML::Command::User::コマンド.pm
</sect1>
+
+<!-- コマンドの例 -->
+&sect.command.internal;
+
+
+<!-- コマンドの拡張例 -->
+&sect.command.extension;
+
+
</chapter>
diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml
new file mode 100644
index 00000000..7a287745
--- /dev/null
+++ b/fml/doc/ja/tutorial/command/extension.sgml
@@ -0,0 +1,32 @@
+<!--
+ $FML$
+-->
+
+
+<sect1 id="fml.command.hack.example0">
+ <title> コマンドの拡張の仕方の例 </title>
+
+
+ <sect2>
+ <title> 独自コマンドを作る。 </title>
+
+ <para>
+ fml 5.0 では、
+ 例えばユーザ向けのコマンド uja を作りたい場合、
+ FML::Command 以下から適当に cut & paste して
+<screen>
+/usr/local/lib/fml/site_local/FML/Command/User/uja.pm
+</screen>
+ というファイルを置けば OK にしようとしています。
+ </para>
+
+<para>
+TODO:
+これだけではだめで、許可するコマンドリストに追加して始めて有効になるよ
+うにしないといけないでしょう。
+このあたりはまだ未定です。
+</para>
+
+</sect2>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml
index 5968573f..6f355342 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.2 2001/05/17 04:25:32 fukachan Exp $
+ $FML: chapter.sgml,v 1.3 2001/08/26 05:55:52 fukachan Exp $
-->
<chapter id="delivery">
@@ -47,7 +47,11 @@ LMTP
mesage => $message
});
</screen>
-ここで $message は Mail::Message オブジェクトです。
+ここで $message は
+<link linkend="module.mail.message">
+Mail::Message
+</link>
+オブジェクトです。
</para>
</sect1>
@@ -55,7 +59,10 @@ LMTP
<sect1>
<title>
- Mail::Message オブジェクト
+ <link linkend="module.mail.message">
+ Mail::Message
+ </link>
+ オブジェクト
</title>
<para>
@@ -68,17 +75,13 @@ header -> preamble -> part1 -> part2 -> trailor (multipart)
</para>
<para>
-Mail::Message のクラスは
+<link linkend="module.mail.message">
+Mail::Message
+</link>
+クラスは
このようなデータ構造に対して、さまざまなオペレーションを提供します。
</para>
-<para>
-参照:
-<ulink url="../../en/modules/Mail/Message.txt">
-Mail::Message モジュールのマニュアル
-</ulink>
-</para>
-
</sect1>
</chapter>
diff --git a/fml/doc/ja/tutorial/delivery/reply.sgml b/fml/doc/ja/tutorial/delivery/reply.sgml
index b0f38ab1..697d6b19 100644
--- a/fml/doc/ja/tutorial/delivery/reply.sgml
+++ b/fml/doc/ja/tutorial/delivery/reply.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: reply.sgml,v 1.2 2001/05/18 10:53:03 fukachan Exp $
+ $FML: reply.sgml,v 1.3 2001/08/26 05:55:52 fukachan Exp $
-->
-<chapter id="reply">
-
- <TITLE> fml からメールを送る </TITLE>
+<chapter id="message.reply">
+ <TITLE>
+ fml からメールで返事を送り返す
+ </TITLE>
<sect1>
<title> 概要 </title>
@@ -12,17 +13,28 @@
<para>
送り返すべきメールは
Mail::Delivery::Queue
-を使い queue に入れられます。
+を使い queue に入れます。
queue に入ったメールは、のちに
FML::Process::QueueManager
クラスが(配送)処理をします。
-</para>
-
-<para>
-queue ファイルは queue ディレクトリから pickup され、
-Mail::Message で parse され
+FML::Process::QueueManager により
+queue ファイルが queue ディレクトリから pickup され、
+Mail::Message で parse され、
FML::Mailer 経由で
-Mail::Delivery が配送処理をします。
+Mail::Delivery が実際にメール配送処理をします。
+<screen>
+Mail::Delivery::Queue
+ ↓
+ ↓→→→ キューディレクトリ
+ ↓
+FML::Process::QueueManager
+ ↓
+ ↓←←← キューディレクトリ
+ ↓
+FML::Mailer
+ ↓
+Mail::Delivery
+</screen>
</para>
</sect1>
@@ -61,7 +73,6 @@ new/ から active/ に移動されます。
</sect1>
-
<sect1>
<title>
fml の中でどうするか?
@@ -96,14 +107,7 @@ $curproc->reply_message( {
</screen>
</para>
-
-<warning>
-<para>
-うーん、言語の変換はどこでどう指示するべきでしょうか?
-</para>
-</warning>
-
-
</sect1>
+
</chapter>
diff --git a/fml/doc/ja/tutorial/devel/cvstree.sgml b/fml/doc/ja/tutorial/devel/cvstree.sgml
index add7b39e..54745add 100644
--- a/fml/doc/ja/tutorial/devel/cvstree.sgml
+++ b/fml/doc/ja/tutorial/devel/cvstree.sgml
@@ -100,6 +100,15 @@ CPAN/ や 3RDPARTY/ 以下のモジュールを変更したい場合は fml5/ 以下でなん
</row>
<row>
+ <entry> img/
+ </entry>
+ <entry>
+ Internet Message Group
+ (だが、IM についてはすでに解散状態か?)
+ </entry>
+ </row>
+
+ <row>
<entry> 3rdparty/
</entry>
<entry> サードパーティ用(予約)
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 4170eecf..e75259ae 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.16 2001/09/30 23:08:23 fukachan Exp $
+ $FML: chapters.ent,v 1.17 2001/10/12 11:14:19 fukachan Exp $
-->
<!entity versin "1.1">
@@ -29,8 +29,9 @@
<!-- コマンド -->
-<!entity chapter.fmlcommand SYSTEM "command/chapter.sgml">
-<!entity sect.command.internal SYSTEM "command/internal.sgml">
+<!entity chapter.fmlcommand SYSTEM "command/chapter.sgml">
+<!entity sect.command.internal SYSTEM "command/internal.sgml">
+<!entity sect.command.extension SYSTEM "command/extension.sgml">
<!-- う〜ん、分類は…?;-) -->
@@ -50,8 +51,8 @@
<!entity chapter.design SYSTEM "internals/design.sgml">
<!entity chapter.config.cf SYSTEM "internals/config.cf.sgml">
<!entity chapter.message SYSTEM "internals/message.sgml">
-<!entity sect.errormessage SYSTEM "internals/errormessage.sgml">
<!entity chapter.nl SYSTEM "internals/nativelanguage.sgml">
+<!entity chapter.message.nl SYSTEM "message/language.sgml">
<!-- 開発 -->
diff --git a/fml/doc/ja/tutorial/install/chapter.sgml b/fml/doc/ja/tutorial/install/chapter.sgml
index d6ac0dbb..b1b7642a 100644
--- a/fml/doc/ja/tutorial/install/chapter.sgml
+++ b/fml/doc/ja/tutorial/install/chapter.sgml
@@ -1,38 +1,40 @@
<!--
- $FML: chapter.sgml,v 1.3 2001/04/24 13:33:34 fukachan Exp $
+ $FML: chapter.sgml,v 1.4 2001/05/01 15:16:27 fukachan Exp $
-->
<chapter id="installation">
-<title> インストール </title>
+ <title> インストール </title>
<!-- ====================================================== -->
<sect1 id="install">
-<title> 概要 </title>
+ <title> 概要 </title>
<para>
対話型インストーラは"まだ"作られていません。
-シェルスクリプトがあるだけです。
</para>
<para>
-トップ・ディレクトリにある INSTALL.sh の先頭にあるディレクトリ名などを
-適当に修正し、
-ユーザ root で実行して下さい。
-</para>
-
+make を実行して下さい。
<screen>
% su root
-# sh INSTALL.sh
+# make install
</screen>
+これはシェルスクリプト INSTALL.sh を実行するだけです。
+</para>
+
+<para>
+変更が必要ならトップ・ディレクトリにある INSTALL.sh の先頭にあるディレ
+クトリ名などを適当に修正し、ユーザ root で実行して下さい。
+</para>
</sect1>
<!-- ====================================================== -->
<sect1>
-<title> 各ディレクトリの役割 </title>
+ <title> 各ディレクトリの役割 </title>
<para>
それぞれのディレクトリの役割は次の通りです。
@@ -41,7 +43,7 @@
<para>
<table>
- <title> ディレクトリの構造 </title>
+ <title> ディレクトリの構造 </title>
<tgroup cols=2>
<thead>
@@ -80,6 +82,16 @@
<row>
<entry>
+ /usr/local/share/fml
+ </entry>
+ <entry>
+ メッセージなどのテンプレート、
+ 言語依存です。
+ </entry>
+ </row>
+
+ <row>
+ <entry>
/var/spool/ml
</entry>
<entry>
@@ -107,7 +119,7 @@
<!-- ====================================================== -->
<sect1 id="upgrade">
-<title> アップグレード </title>
+ <title> アップグレード </title>
<para>
単に、もう一度
@@ -124,7 +136,7 @@
</sect1>
<sect1>
-<title> ダウングレード </title>
+ <title> ダウングレード </title>
<para>
/etc/fml/main.cf の fml_verison をアップグレード前のものに
diff --git a/fml/doc/ja/tutorial/internals/dbms.sgml b/fml/doc/ja/tutorial/internals/dbms.sgml
index 0f393c0c..10955599 100644
--- a/fml/doc/ja/tutorial/internals/dbms.sgml
+++ b/fml/doc/ja/tutorial/internals/dbms.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: db.sgml,v 1.1 2001/08/05 12:33:50 fukachan Exp $
+ $FML: dbms.sgml,v 1.1 2001/08/19 12:53:08 fukachan Exp $
-->
<chapter id="dbms">
@@ -8,8 +8,17 @@
</title>
<para>
-ごめん、この章は予約しただけで、書いてないです _o_
+DBMS との通信は
+<link linkend="module.io.adapter">
+IO::Adapter
+</link>
+クラス経由で通信することが前提です。
</para>
+<para>
+データの挿入や削除といった基本的な機能はこのクラスが提供します。
+それらの原始的な機能を組み合わせた複雑な操作は
+IO::Adapter の前段階のプログラムが頑張る必要があります。
+</para>
</chapter>
diff --git a/fml/doc/ja/tutorial/internals/design.sgml b/fml/doc/ja/tutorial/internals/design.sgml
index 09f31695..1a567715 100644
--- a/fml/doc/ja/tutorial/internals/design.sgml
+++ b/fml/doc/ja/tutorial/internals/design.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: design.sgml,v 1.2 2001/05/10 03:11:43 fukachan Exp $
+ $FML: design.sgml,v 1.3 2001/09/29 10:44:29 fukachan Exp $
-->
<chapter id="design">
-
-<title>fml5 (仮名) のデザインコンセプト</title>
+ <title>
+ fml5 (仮名) のデザインコンセプト
+ </title>
<!-- ========================================================
diff --git a/fml/doc/ja/tutorial/internals/errormessage.sgml b/fml/doc/ja/tutorial/internals/errormessage.sgml
deleted file mode 100644
index 478eadb6..00000000
--- a/fml/doc/ja/tutorial/internals/errormessage.sgml
+++ /dev/null
@@ -1,200 +0,0 @@
-<!--
- $FML: errormessage.sgml,v 1.3 2001/06/01 04:31:01 fukachan Exp $
--->
-
-<sect1>
- <title>
- メッセージの多国語化対応
- </title>
-
-<para>
-<screen>
-$curproc->reply_message_nl('error.already_member',
- 'already member',
- { _arg_address => $address });
-</screen>
-は
-/usr/local/share/fml/message/euc-jp/error/already_member
-というテンプレートを用いてメッセージを構築します。
-</para>
-
-<para>
-メッセージ中の $変数名、例えば、
-<screen>
-$_args_address
-</para>
-</screen>
-はハッシュリファレンスとして与えられた引数へ展開されます。
-config.cf 中で定義されている変数も同様に展開可能です。
-例えば $ml_name はML名に展開されます。
-</para>
-
-</sect1>
-
-
-<sect1>
- <title> 議論: エラーメッセージを返す </title>
-
-<para>
-適宜、エラーメッセージを送信者に返す必要があります。
-それもエラーメッセージは言語依存です。
-何らかの形で言語変換をしてから送り出すわけです。
-</para>
-
-
-<!-- ===================================================== -->
-<sect2>
- <title> fml 4.0 の場合 </title>
-
-<para>
-fml 4.0 では
-<screen>
- Mesg(*e, キーワード, デフォルトのメッセージ, 変換に使う引数);
-</screen>
-の形で呼び出します。
-</para>
-
-<para>
-/usr/local/fml/messages/Japanese/
-以下にあるファイル群に対して、
-キーワード検索を行ないます。
-各ファイルにはカテゴリごとに分類されたキーワードとメッセージが
-定義されています。
-つまり各ファイルに複数のキーワードが定義されています。
-</para>
-
-<para>
-例えば、キーワードが not_found の場合、
-/usr/local/fml/messages/Japanese/kern
-の not_found という欄が該当します。
-</para>
-
-</sect2>
-
-
-
-<!-- ===================================================== -->
-<sect2>
- <title> fml 5.0 はどうするべきか? </title>
-
-<para>
-一つのファイルに一つのキーワードを持つのと、
-カテゴリごとに複数のキーワードを持つのとどちらが
-カスタマイズしやすいのでしょうか?
-僕には良くわかりません。
-</para>
-
-<sect3>
- <title>
- X/Open Portability Guide Issue 4 Version 2 (``XPG4.2'')
- </title>
-
-<para>
-XPG (X/Open の規格)を使う場合は
-<screen>
-catgets(catd, set_id, msg_id, char *s);
-</screen>
-で、LOCALE_○○ で指定された言語へ変換しています。
- <footnote>
- <para>
- ここで s はデフォルトのメッセージとなります。
- </para>
- </footnote>
-例えば、次のような使い方をします。
-<screen>
-printf(catgets(catd, 30, 4, "%s: Internal match error.\n"), progname);
-</screen>
-この時、
-locale の定義ファイル(
-例: /usr/pkg/share/nls/ja_JP.EUC/プログラム名.cat
-)
-の中の se 30、エントリ 4 のメッセージに変換してくれます。
-</para>
-
-</sect3>
-
-<sect3>
- <title>
- fml 5.0: とりあえずの方針
- </title>
-
-<para>
-問題の一つは locale に対応するか?という問題です。
-makefml を筆頭に、各種コマンド群のエラーメッセージの日本語化
-を考えると、
-locale を考えておくのも悪くはないのかとも思います。
-この場合は locale ぽくするために
-<screen>
-/usr/local/lib/fml/バージョン/messages/ja_JP.EUC/kern
-
-1: %s は見つかりません
-2: %s は %d のエラーです
-</screen>
-といったものにしておくと後で便利そうです。
-</para>
-
-<para>
-逆に、一つのキーワードごとに別のファイルにしておく構成も可能です。
-これは特定の一つのキーワードだけ変えたい場合に便利そうです。
-</para>
-
-<para>
-もし、後者の方法を試してみることにすると、
-<screen>
-FML::Message::ja::キーワード
-</screen>
-というクラスをじゃんじゃん作るような作り方になるでしょう。
-例えば
-<screen>
-FML::Message::ja::not_found
-</screen>
-などと2、300個のファイルが作られることになります(まじか?)。
-</para>
-
-<para>
-この方法の問題点は
-<itemizedlist>
- <listitem>
- <para>
- ファイルがバラバラになる
- (逆に長所としてカスタマイズしやすくなる)
- </para>
- </listitem>
-
- <listitem>
- <para>
- ファイルがバラバラになることで locale ぽくなくなるが?
- locale 対応を考えると面倒じゃないだろうか?
- </para>
- </listitem>
-
-</itemizedlist>
-あたりにあるでしょう。
-</para>
-
-
-<para>
-また、各メッセージテンプレートはどのようなものであるべきだろうか?
-後者の場合、
-<screen>
-sub not_found
-{
- my .. = @_;
-
- return <<"_EOF_"
-$sender はどうーたら
-_EOF_
-}
-</screen>
-といった関数を一杯作ることもできます。
-つまり単なる引数ではなく意味の分かりやすいものにすることを考えたわけです。
-しかし、これは本当にカスタマイズしやすいでしょうか?
-locale 化を考えるなら、これはこれで面倒な気がするわけですが…
-</para>
-
-</sect3>
-
-
-</sect2>
-
-</sect1>
diff --git a/fml/doc/ja/tutorial/internals/ioadapter.sgml b/fml/doc/ja/tutorial/internals/ioadapter.sgml
deleted file mode 100644
index 83000608..00000000
--- a/fml/doc/ja/tutorial/internals/ioadapter.sgml
+++ /dev/null
@@ -1,77 +0,0 @@
-<!--
- $FML: db.sgml,v 1.3 2001/08/19 14:55:38 fukachan Exp $
--->
-
-<chapter id="io.adapter">
- <title>
- IO::Adapter
- </title>
-
-<sect1>
- <title>
- IO へのアダプター層 (IO::Adapter)
- </title>
-
-<para>
-fml 5.0 でのメンバーリストの読み書きは
-IO::Adapter という抽象クラスを通じて、
-アドレスの登録/削除を行なうようになっています。
-</para>
-
-<para>
-例えば次のように使っています。
-<screen>
-use IO::Adapter;
-$obj = new IO::Adapter ($map, $map_params);
-$obj->open || croak("cannot open $map");
-while ($x = $obj->getline) { ... }
-$obj->close;
-</screen>
-ここで $map は次のようなものが使えます。
-<screen>
-file:/var/spool/ml/elena/actives
-unix.group:root
-nis.group:root
-mysql:id
-postgresql:id (未実装)
-ldap:id (未実装)
-</screen>
-</para>
-
-<para>
-file: は通常のファイルです。
-unix.group:root は /etc/group の root のエントリにあるユーザのリストを、
-nis.group:root は NIS の root のエントリにあるユーザのリストです。
-</para>
-
-<para>
-mysql:id は MySQL へのアクセスです。
-mysql:id で指定されたパラメータを用います。
-このパラメータは new() を実行する際に別途与える必要があります。
-<screen>
-my $map = 'mysql:toymodel';
-my $map_params = {
- $map => {
- sql_server => 'localhost',
- user => 'fukachan',
- user_password => 'uja',
- database => 'fml',
- table => 'ml',
- params => {
- ml_name => 'elena',
- file => 'members',
- },
- },
-};
-
-my $obj = new IO::Adapter ($map, $map_params);
-$obj->open();
-$obj->add( 'rudo@nuinui.net' );
-$obj->close();
-</screen>
-</para>
-
-</sect1>
-
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/internals/message.sgml b/fml/doc/ja/tutorial/internals/message.sgml
index 7b46993a..495c9c3d 100644
--- a/fml/doc/ja/tutorial/internals/message.sgml
+++ b/fml/doc/ja/tutorial/internals/message.sgml
@@ -1,9 +1,20 @@
<!--
- $FML: message.sgml,v 1.5 2001/09/23 10:59:20 fukachan Exp $
+ $FML: message.sgml,v 1.6 2001/09/30 23:09:39 fukachan Exp $
-->
-<chapter id="message">
- <title> メール(メッセージ)の取り扱い </title>
+<chapter id="mail.manipulation">
+ <title> メールの操作 </title>
+
+<para>
+メール(オブジェクト)を扱う関数の詳細については
+<link linkend="module.mail.message">
+Mail::Message クラス
+</link>
+を見て下さい。
+このクラスが基本的な操作法を提供しています。
+Mail::Bounce や Mail::Delivery を始め、
+あらゆる関数がこのクラスに依存しています。
+</para>
<!-- ======================================= -->
@@ -24,7 +35,11 @@ multipart のように、
</para>
<para>
-それらのモジュールのために Mail::Message クラスがあり、
+それらのモジュールのために
+<link linkend="module.mail.message">
+Mail::Message クラス
+</link>
+があり、
メールの構造を表現するために用いられています。
このクラスは
Mail::Bounce や Mail::Delivery を始め、
@@ -90,7 +105,4 @@ MIME::Lite クラスへ
</sect1>
-
-&sect.errormessage;
-
</chapter>
diff --git a/fml/doc/ja/tutorial/internals/nativelanguage.sgml b/fml/doc/ja/tutorial/internals/nativelanguage.sgml
index febc28cf..dbaf3a63 100644
--- a/fml/doc/ja/tutorial/internals/nativelanguage.sgml
+++ b/fml/doc/ja/tutorial/internals/nativelanguage.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: nativelanguage.sgml,v 1.2 2001/08/05 12:33:18 fukachan Exp $
+ $FML: nativelanguage.sgml,v 1.3 2001/08/05 12:39:13 fukachan Exp $
-->
<chapter>
<title> 言語別の処理関数 </title>
+
<para>
fml 内部では言語に依存した変換処理が必要です。
例えば、JIS と EUC の相互変換は随所で必要です。
@@ -12,6 +13,15 @@ fml 内部では言語に依存した変換処理が必要です。
プログラムでは EUC の方が扱いやすいためです。
</para>
+<para>
+コマンドの返事の言語依存性については
+<link linkend="message.nl">
+『メッセージの他国語化』
+</link>
+の章を参照して下さい。
+</para>
+
+
<sect1>
<title>
何か::Language::
@@ -38,7 +48,6 @@ Mail::Bounce::Language::Japanese.pm
日本語に依存したエラーメール解析ルーチンを提供しています。
</para>
-
</sect1>
diff --git a/fml/doc/ja/tutorial/internals/style.sgml b/fml/doc/ja/tutorial/internals/style.sgml
index 87365aa2..4f7c4150 100644
--- a/fml/doc/ja/tutorial/internals/style.sgml
+++ b/fml/doc/ja/tutorial/internals/style.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: style.sgml,v 1.1 2001/04/26 08:58:36 fukachan Exp $
+ $FML: style.sgml,v 1.1 2001/05/01 15:16:27 fukachan Exp $
-->
<chapter id="programingstyle">
@@ -10,6 +10,14 @@
ここでは、プログラミング上のいくつかの諸問題についてまとめます。
</para>
+<para>
+FML.ORG のソフトウエアのコーディングスタイルについては
+<ulink url="http://www.fml.org/software/FNF/">
+FNF
+</ulink>
+を参照して下さい。
+</para>
+
<!-- ==================================================== -->
<sect1 id="variable-naming-convention">
diff --git a/fml/doc/ja/tutorial/module/Mail::Message.sgml b/fml/doc/ja/tutorial/module/Mail::Message.sgml
index e26acdb0..5b1e396c 100644
--- a/fml/doc/ja/tutorial/module/Mail::Message.sgml
+++ b/fml/doc/ja/tutorial/module/Mail::Message.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: Mail::Message.sgml,v 1.2 2001/09/23 12:18:17 fukachan Exp $
+ $FML: Mail::Message.sgml,v 1.3 2001/09/30 23:09:39 fukachan Exp $
-->
<chapter id="module.mail.message">
@@ -345,5 +345,18 @@ data_in_body_part($size)
</sect1>
+<sect1>
+ <title>
+ 参照
+ </title>
+
+<para>
+
+<ulink url="../../en/modules/Mail/Message.txt">
+Mail::Message モジュールの(英語)マニュアル
+</ulink>
+</para>
+</sect1>
+
</chapter>
diff --git a/fml/doc/ja/tutorial/overview/available.sgml b/fml/doc/ja/tutorial/overview/available.sgml
index 34c041ec..5e55bf40 100644
--- a/fml/doc/ja/tutorial/overview/available.sgml
+++ b/fml/doc/ja/tutorial/overview/available.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: available.sgml,v 1.1 2001/04/25 03:54:02 fukachan Exp $
+ $FML: available.sgml,v 1.1 2001/05/01 15:38:05 fukachan Exp $
-->
<chapter id="available">
-
- <title> fml-devel の機能 </title>
+ <title>
+ fml-devel の実行形式プログラム
+ </title>
<para>
/usr/local/bin 以下にインストールされるものと、
diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml
index 100fff60..8759d382 100644
--- a/fml/doc/ja/tutorial/overview/chapter.sgml
+++ b/fml/doc/ja/tutorial/overview/chapter.sgml
@@ -1,9 +1,11 @@
<!--
- $FML: chapter.sgml,v 1.1 2001/04/25 14:30:20 fukachan Exp $
+ $FML: chapter.sgml,v 1.2 2001/05/07 03:16:25 fukachan Exp $
-->
<chapter id="overview">
-<title> おおまかな流れ </title>
+ <title>
+ おおまかな流れ
+ </title>
<sect1>
<title> 概要 </title>
diff --git a/fml/doc/ja/tutorial/overview/download.sgml b/fml/doc/ja/tutorial/overview/download.sgml
index aa92e88a..d221296b 100644
--- a/fml/doc/ja/tutorial/overview/download.sgml
+++ b/fml/doc/ja/tutorial/overview/download.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: download.sgml,v 1.1 2001/04/24 10:06:36 fukachan Exp $
+ $FML: download.sgml,v 1.1 2001/05/01 15:38:06 fukachan Exp $
-->
<chapter id="download">
@@ -25,6 +25,10 @@ fml-devel のソースは
日付の新しいものを選んでダウンロードして下さい。
</para>
+<para>
+なお daily snapshot もあります。
+</para>
+
</sect1>
@@ -34,19 +38,14 @@ fml-devel のソースは
<title> cvs へのアクセス </title>
<para>
-anonymous CVS へのアクセスはまだできません。
-anoncvs.fml.org は準備中です
-(ちょっと待ってください。
-マシンが壊れてしまったのですが、復旧予定不明)。
+anoncvs.fml.org の fmlsrc 以下が fml 5.0 ブランチです。
</para>
<para>
cvs.fml.org にアクセスできる権限のある人は
-
<screen>
cvs -d cvs.fml.org:/cvsroot co fmlsrc
</screen>
-
でアクセスできます(注: cvs over ssh のみがサポートされます)。
</para>
diff --git a/fml/doc/ja/tutorial/programs/makefml.sgml b/fml/doc/ja/tutorial/programs/makefml.sgml
index 267eb3bc..46b18f87 100644
--- a/fml/doc/ja/tutorial/programs/makefml.sgml
+++ b/fml/doc/ja/tutorial/programs/makefml.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: makefml.sgml,v 1.2 2001/04/26 11:02:40 fukachan Exp $
+ $FML: makefml.sgml,v 1.3 2001/09/13 13:29:00 fukachan Exp $
-->
<sect1 id="makefml">
@@ -64,7 +64,11 @@ makefml の基本的な使い方は fml 4.0 の makefml と同様です。
</listitem>
</itemizedlist>
-詳しくは FML::Command::Admin のクラスを見て下さい。
+コマンドについては詳しくは
+<link linkend="fml.command.op">
+コマンド
+</link>
+の章を参照して下さい。
</para>
</sect1>