summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial/command
diff options
context:
space:
mode:
Diffstat (limited to 'fml/doc/ja/tutorial/command')
-rw-r--r--fml/doc/ja/tutorial/command/extension.sgml8
-rw-r--r--fml/doc/ja/tutorial/command/internal.sgml39
-rw-r--r--fml/doc/ja/tutorial/command/module.sgml61
3 files changed, 62 insertions, 46 deletions
diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml
index 73aed185..97e07e2c 100644
--- a/fml/doc/ja/tutorial/command/extension.sgml
+++ b/fml/doc/ja/tutorial/command/extension.sgml
@@ -1,17 +1,19 @@
<!--
- $FML: extension.sgml,v 1.2 2001/11/24 03:22:53 fukachan Exp $
+ $FML: extension.sgml,v 1.3 2002/04/01 23:41:00 fukachan Exp $
-->
<sect1 id="fml.command.hack.example0">
- <title> コマンドの拡張の仕方 (予定) </title>
+ <title>
+ コマンドの拡張の仕方 (予定)
+ </title>
<sect2>
<title> 独自コマンドを作る。 </title>
<para>
- fml 5.0 では、
+ &fmldevel; では、
例えばユーザ向けのコマンド uja を作りたい場合、
FML::Command 以下から適当に cut & paste して
<screen>
diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml
index 40cd1ae3..222abc7b 100644
--- a/fml/doc/ja/tutorial/command/internal.sgml
+++ b/fml/doc/ja/tutorial/command/internal.sgml
@@ -1,11 +1,11 @@
<!--
- $FML: internal.sgml,v 1.2 2001/11/24 03:22:53 fukachan Exp $
+ $FML: internal.sgml,v 1.3 2002/04/01 23:41:00 fukachan Exp $
-->
<sect1 id="fml.command.interal.change">
<title>
議論:
- 『4.0 と 5.0 のコードの書き方はどのくらい違うか?』
+ 『4.0 と &fmldevel; のコードの書き方はどのくらい違うか?』
</title>
<para>
@@ -15,28 +15,29 @@
<para>
5.0 では help ファイルを送り返すコードの実体は
- FML::Command::User::help にあり、
- FML::Process::Command クラスから
- (FML::Command の AUTOLOAD を経由して)呼び出されます。
+FML::Command::User::help にあり、
+FML::Process::Command クラスから
+(FML::Command の AUTOLOAD を経由して)呼び出されます。
</para>
<warning>
<para>
- 注意: 全てのコマンドは FML::Command::User::コマンド もしくは
- FML::Command::Admin::コマンド クラスとして実装されています。
- なお makefml は FML::Command::Admin::コマンド を使います。
+全てのコマンドは FML::Command::User::コマンド もしくは
+FML::Command::Admin::コマンド クラスとして実装されています。
+なお makefml や CGI は FML::Command::Admin::コマンド を使います。
+コマンドメールは User や Admin を適宜使い分けます。
</para>
</warning>
<para>
-help の実体は FML::Command::User::help のこの関数です。
+例えば help の実体は FML::Command::User::help の process() 関数です。
<screen>
sub process
{
my ($self, $curproc, $optargs) = @_;
- my $config = $curproc->{ config };
- my $charset = $config->{ reply_message_charset };
- my $help_file = $config->{ help_file };
+ my $config = $curproc->{ config };
+ my $charset = $config->{ reply_message_charset };
+ my $help_file = $config->{ help_file };
# template substitution: kanji code, $varname expansion et. al.
my $params = {
@@ -82,11 +83,15 @@ $curproc->reply_message() は引数によって振舞いがことなりますが、
</para>
<para>
-この仕組みは fml 4.0 の Notify() と同様ですが、あらゆるメッセージがキュー
-に入れられ、最後に一気に処理されるという点で大きく異なります。get コマ
-ンドなども同じように扱われます。つまり 4.0 の Notify() 相当部分が(通常
-の記事配送以外の)あらゆる送信機能を担当するということです。
-この点において、送信のキューイングのメカニズムは大きく異なっています。
+この仕組みは &fml4; の Notify() と同様ですが、あらゆるメッセージがキュー
+に入れられ、最後に一気に処理されるという点で大きく異なります。
+</para>
+
+<para>
+なお get コマンドなども同じキューイングの仕組みを使っています。つまり
+4.0 の Notify() 相当部分が(通常の記事配送以外の)あらゆる送信機能を担当
+するということです。この点において、送信のキューイングのメカニズムは大
+きく異なっています。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/command/module.sgml b/fml/doc/ja/tutorial/command/module.sgml
index fd0fdd24..5e648bee 100644
--- a/fml/doc/ja/tutorial/command/module.sgml
+++ b/fml/doc/ja/tutorial/command/module.sgml
@@ -1,5 +1,5 @@
<!--
- $FML$
+ $FML: module.sgml,v 1.1 2001/11/24 03:22:53 fukachan Exp $
-->
@@ -9,7 +9,7 @@
</title>
<para>
-5.0 では、
+&fmldevel; では、
コマンドメール、makefml そして CGI が使うモジュール
は共有されています。
ただし、その権限の差異によって、
@@ -20,71 +20,80 @@
<para>
FML::Command:: クラスは以下のような構成になっています。
<screen>
-FML::Command.pm FML::Command クラス以下への入口
-FML::Command::ACL ACL
+FML::Command FML::Command クラス以下への入口
FML::Command::Utils よもやまの定義
FML::Command::User ユーザ用コマンド群
FML::Command::Admin 管理者用コマンド群
</screen>
例えば、(メールでの)ユーザ用のコマンドの場合
-FML::Command.pm を経由して
-FML::Command::User::コマンド.pm
+FML::Command を経由して
+FML::Command::User::コマンド
モジュールを使うことになります。
</para>
<sect2>
- <title> (メールでの)一般ユーザ用コマンド </title>
+ <title>
+ (メールでの)一般ユーザ用コマンド
+ </title>
+
<para>
-FML::Process::Command.pm から
-FML::Command.pm 経由で
-FML::Command::User::コマンド.pm
+FML::Process::Command から
+FML::Command 経由で
+FML::Command::User::コマンド
を用います。
</para>
<para>
最終的に
-FML::Command::Admin::コマンド.pm
+FML::Command::Admin::コマンド
を使うモジュールもあります。
例えば登録と削除の実作業は
-FML::Command::Admin::コマンド.pm
+FML::Command::Admin::コマンド
が行なっています。この場合
-FML::Command::User::コマンド.pm
+FML::Command::User::コマンド
のコマンドは confirm を行なうための wrapper です。
</para>
</sect2>
<sect2>
- <title> (メールでの) adminコマンド </title>
+ <title>
+ (メールでの) adminコマンド
+ </title>
<para>
-FML::Process::Command.pm から
-FML::Command.pm 経由で
-FML::Command::Admin::コマンド.pm
+FML::Process::Command から
+FML::Command 経由で
+FML::Command::Admin::コマンド
を用います。
</para>
</sect2>
<sect2>
- <title> makefml のコマンド </title>
+ <title>
+ makefml のコマンド
+ </title>
<para>
-FML::Process::Configure.pm から
-FML::Command.pm 経由で
-FML::Command::Admin::コマンド.pm
+FML::Process::Configure から
+FML::Command 経由で
+FML::Command::Admin::コマンド
を用います。
</para>
</sect2>
<sect2>
- <title> CGI (予定) </title>
+ <title>
+ CGI
+ </title>
+
<para>
-FML::Process::CGI.pm から
-FML::Command.pm 経由で
-FML::Command::Admin::コマンド.pm
-を用います(予定)。
+FML::Process::CGI から
+FML::Command 経由で
+FML::Command::Admin::コマンド
+を用います。
</para>
</sect2>