summaryrefslogtreecommitdiff
path: root/fml/doc/ja
diff options
context:
space:
mode:
authorfukachan <fukachan>2002-07-07 01:57:10 +0000
committerfukachan <fukachan>2002-07-07 01:57:10 +0000
commitd71fd2752b575ff5b46e09b94d4fca40570c0f71 (patch)
tree8a64e9c5ec1dc31f53c9c25e49b7b554bdb35e68 /fml/doc/ja
parentfdcca16caee1f2d98f4519fe9bdaf8e079ba2f4c (diff)
downloadfml8-d71fd2752b575ff5b46e09b94d4fca40570c0f71.tar.gz
fml8-d71fd2752b575ff5b46e09b94d4fca40570c0f71.tar.bz2
fml8-d71fd2752b575ff5b46e09b94d4fca40570c0f71.zip
clean up, sync w/ reality
Diffstat (limited to 'fml/doc/ja')
-rw-r--r--fml/doc/ja/tutorial/command/chapter.sgml4
-rw-r--r--fml/doc/ja/tutorial/command/internal.sgml14
-rw-r--r--fml/doc/ja/tutorial/command/module.sgml8
-rw-r--r--fml/doc/ja/tutorial/module/Mail::Message.sgml6
-rw-r--r--fml/doc/ja/tutorial/overview/fml.sgml48
-rw-r--r--fml/doc/ja/tutorial/usage/command.sgml4
-rw-r--r--fml/doc/ja/tutorial/usage/customize.sgml4
-rw-r--r--fml/doc/ja/tutorial/usage/fmlconf.sgml14
-rw-r--r--fml/doc/ja/tutorial/usage/fmldoc.sgml7
-rw-r--r--fml/doc/ja/tutorial/usage/fmlhtmlify.sgml13
-rw-r--r--fml/doc/ja/tutorial/usage/fmlthread.sgml7
-rw-r--r--fml/doc/ja/tutorial/usage/makefml.sgml42
-rw-r--r--fml/doc/ja/tutorial/usage/post.sgml17
13 files changed, 133 insertions, 55 deletions
diff --git a/fml/doc/ja/tutorial/command/chapter.sgml b/fml/doc/ja/tutorial/command/chapter.sgml
index 41c031b4..d84cd759 100644
--- a/fml/doc/ja/tutorial/command/chapter.sgml
+++ b/fml/doc/ja/tutorial/command/chapter.sgml
@@ -1,10 +1,10 @@
<!--
- $FML$
+ $FML: chapter.sgml,v 1.5 2002/07/05 04:01:36 fukachan Exp $
-->
<chapter>
<title>
- コマンドの拡張
+ コマンド(コマンドメール、makefml、CGI)
</title>
diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml
index 222abc7b..c8002d31 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.3 2002/04/01 23:41:00 fukachan Exp $
+ $FML: internal.sgml,v 1.4 2002/07/02 10:39:30 fukachan Exp $
-->
<sect1 id="fml.command.interal.change">
<title>
- 議論:
- 『4.0 と &fmldevel; のコードの書き方はどのくらい違うか?』
+ 補足:
+ 『&fml4;と &fmldevel; のコードの書き方はどのくらい違うか?』
</title>
<para>
@@ -14,7 +14,7 @@
</para>
<para>
-5.0 では help ファイルを送り返すコードの実体は
+&fmldevel; では help ファイルを送り返すコードの実体は
FML::Command::User::help にあり、
FML::Process::Command クラスから
(FML::Command の AUTOLOAD を経由して)呼び出されます。
@@ -89,9 +89,9 @@ $curproc->reply_message() は引数によって振舞いがことなりますが、
<para>
なお get コマンドなども同じキューイングの仕組みを使っています。つまり
-4.0 の Notify() 相当部分が(通常の記事配送以外の)あらゆる送信機能を担当
-するということです。この点において、送信のキューイングのメカニズムは大
-きく異なっています。
+&fml4; の Notify() 相当部分が(通常の記事配送以外の)あらゆる送信機能を
+担当するということです。この点において、送信のキューイングのメカニズム
+は大きく異なっています。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/command/module.sgml b/fml/doc/ja/tutorial/command/module.sgml
index 5e648bee..5b8cf82b 100644
--- a/fml/doc/ja/tutorial/command/module.sgml
+++ b/fml/doc/ja/tutorial/command/module.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: module.sgml,v 1.1 2001/11/24 03:22:53 fukachan Exp $
+ $FML: module.sgml,v 1.2 2002/07/02 10:39:31 fukachan Exp $
-->
@@ -49,9 +49,11 @@ FML::Command::Admin::コマンド
を使うモジュールもあります。
例えば登録と削除の実作業は
FML::Command::Admin::コマンド
-が行なっています。この場合
+内のコードが行なっています。
+登録/削除のコードはすべてのプログラムで共有するためです。
+この場合
FML::Command::User::コマンド
-のコマンドは confirm を行なうための wrapper です。
+のコマンドは confirm を行なうための wrapper という位置付けになります。
</para>
</sect2>
diff --git a/fml/doc/ja/tutorial/module/Mail::Message.sgml b/fml/doc/ja/tutorial/module/Mail::Message.sgml
index 23cceb39..e0d30116 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.5 2002/01/16 14:12:37 fukachan Exp $
+ $FML: Mail::Message.sgml,v 1.6 2002/04/01 23:41:05 fukachan Exp $
-->
<chapter id="module.mail.message">
@@ -29,7 +29,7 @@ header -> body
header -> preamble -> part1 -> part2 -> trailor
</screen>
のようにオブジェクトが数珠つなぎのようなデータ構造を作ります。
-ちなみに鎖の鎖の鎖の間の double link list です。
+ちなみに鎖と鎖の間は double link list です。
Mail::Message のクラスは
このようなデータ構造に対して、さまざまなオペレーションを提供します。
</para>
@@ -75,7 +75,7 @@ parse() メソッドは
data_type_list()
鎖の列の情報を返します。
-情報は HASH ARRAY の形で返されます。
+情報は ARRAY REFERENCE の形で返されます。
例えば MIME/Multipart は次のようになります。
<screen>
type[ 1]: text/rfc822-headers | multipart/mixed
diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml
index 2e9726e7..4bfe2ef5 100644
--- a/fml/doc/ja/tutorial/overview/fml.sgml
+++ b/fml/doc/ja/tutorial/overview/fml.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: fml.sgml,v 1.1 2002/07/02 10:39:37 fukachan Exp $
+ $FML: fml.sgml,v 1.2 2002/07/04 10:59:01 fukachan Exp $
-->
<chapter id="overview">
@@ -34,13 +34,24 @@
<listitem>
<para>
- makefml によるMLの作成/削除、メンバーの登録/削除など
+ makefml によるコマンド操作:
+ MLの作成/削除、
+ メンバーの登録/削除/変更(chaddr)、
+ リモート管理者の登録/削除、
+ ログを見る、
+ メンバーリストを見る、
+ 他
</para>
</listitem>
<listitem>
<para>
- CGI によるMLの作成/削除、メンバーの登録/削除など
+ CGI による操作:
+ MLの作成/削除、
+ メンバーの登録/削除/変更(chaddr)、
+ リモート管理者の登録/削除、
+ ログを見る、
+ メンバーリストを見る、
</para>
</listitem>
@@ -50,6 +61,29 @@
配送、
ヘッダの書き換え、
フィルタ( 4.0 の Envelope Filter と Content Filter に相当するもの )、
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ コマンドメール(一般ユーザ):
+ メンバーの登録/削除/変更(chaddr)、
+ リモート管理者の登録/削除、
+ ログを見る、
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ コマンドメール(リモート管理者):
+ メンバーの登録/削除/変更(chaddr)、
+ リモート管理者の登録/削除、
+ ログを見る、
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
エラーメール解析
</para>
</listitem>
@@ -72,7 +106,7 @@
<listitem>
<para>
- 記事の HTML 化システム:
+ 記事の HTML 化(デフォルトで HTML 版も作る):
fmlhtmlify および makefml に HTML 化コマンドがあります。
</para>
</listitem>
@@ -88,7 +122,7 @@
<listitem>
<para>
- いくつかのユーティリティ:
+ 管理を支援するユーティリティ:
fmlconf
fmldoc
fmlhtmlify
@@ -327,7 +361,7 @@ elena@nuinui.net を作る場合は、次のように実行して下さい。
<!-- ============================================================= -->
<sect1 id="guide.config.cf">
<title>
- MLの設定をカスタマイズをする
+ MLの設定のカスタマイズ
</title>
<warning>
@@ -371,7 +405,7 @@ elena MLの設定のカスタマイズは
/var/spool/ml/elena/config.cf
を編集して下さい。
フォーマットは postfix の設定ファイルと同様です(&fml4; の config.ph よ
-りは cf にやや近いですが)。わかりやすいでしょ?:-)
+りは cf にやや近いですが)。
</para>
<para>
diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml
index 99b288cc..21d25da8 100644
--- a/fml/doc/ja/tutorial/usage/command.sgml
+++ b/fml/doc/ja/tutorial/usage/command.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: command.sgml,v 1.2 2002/07/02 10:39:38 fukachan Exp $
+ $FML: command.sgml,v 1.3 2002/07/05 04:01:37 fukachan Exp $
-->
<sect1 id="fml.command.bymail">
@@ -32,7 +32,7 @@ fml.pl はメールを標準入力から受けとり、
<warning>
<para>
-4.0 と違い、5.0 ではコマンドの結果を
+&fml4; と違い、&fmldevel; ではコマンドの結果を
<link linkend="message.reply">
一通のメール ( MIME/Multipart )にまとめて返送
</link>
diff --git a/fml/doc/ja/tutorial/usage/customize.sgml b/fml/doc/ja/tutorial/usage/customize.sgml
index 87818835..81cfc738 100644
--- a/fml/doc/ja/tutorial/usage/customize.sgml
+++ b/fml/doc/ja/tutorial/usage/customize.sgml
@@ -1,7 +1,7 @@
<!--
- $FML: post.sgml,v 1.3 2002/04/01 23:41:07 fukachan Exp $
+ $FML: customize.sgml,v 1.1 2002/07/05 04:01:37 fukachan Exp $
-->
-<chapter id="usage.cuctomize">
+<chapter id="cuctomize">
<title>
カスタマイズの事例
</title>
diff --git a/fml/doc/ja/tutorial/usage/fmlconf.sgml b/fml/doc/ja/tutorial/usage/fmlconf.sgml
index 50785e8f..ac9739ed 100644
--- a/fml/doc/ja/tutorial/usage/fmlconf.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlconf.sgml
@@ -1,21 +1,27 @@
<!--
- $FML: fmlconf.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
+ $FML: fmlconf.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $
-->
<sect1 id="usage.fmlconf">
-
-<title> 設定を表示する (fmlconf) </title>
+ <title>
+ 設定を表示する (fmlconf)
+ </title>
<para>
fmlconf (/usr/local/bin/fmlconf)
は引数にML名をとり、そのMLの変数一覧を表示します。
-n をつけるとデフォルトと異なる変数のみを表示します。
+</para>
+<para>
+変数一覧を表示する。
<screen>
% fmlconf elena
+</screen>
+デフォルト値と異なる変数を表示する。
+<screen>
% fmlconf -n elena
</screen>
-
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/usage/fmldoc.sgml b/fml/doc/ja/tutorial/usage/fmldoc.sgml
index 302fbef2..ef488294 100644
--- a/fml/doc/ja/tutorial/usage/fmldoc.sgml
+++ b/fml/doc/ja/tutorial/usage/fmldoc.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: fmldoc.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+ $FML: fmldoc.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
-->
<sect1 id="usage.fmldoc">
-
-<title> モジュールのドキュメントを表示する (fmldoc) </title>
+ <title>
+ モジュールのドキュメントを表示する (fmldoc)
+ </title>
<para>
fmldoc の使い方は perldoc と同様です。
diff --git a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
index fe5bcdef..51b3830a 100644
--- a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
@@ -1,16 +1,19 @@
<!--
- $FML: fmlhtmlify.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+ $FML: fmlhtmlify.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
-->
<sect1 id="usage.fmlhtmlify">
-
-<title> 記事を HTML 化する (fmlhtmlify) </title>
+ <title>
+ 記事を HTML 化する (fmlhtmlify)
+ </title>
<para>
+[TODO] ん、これでいいのか?
<screen>
-% fmlhtmlify ML名
+% fmlhtmlify MLのホーム 作る先
+
+% fmlhtmlify /var/spool/ml/elena /some/where/mlarchive/elena
</screen>
</para>
-</sect1>
diff --git a/fml/doc/ja/tutorial/usage/fmlthread.sgml b/fml/doc/ja/tutorial/usage/fmlthread.sgml
index 0421b84f..ed5ab6fc 100644
--- a/fml/doc/ja/tutorial/usage/fmlthread.sgml
+++ b/fml/doc/ja/tutorial/usage/fmlthread.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: fmlthread.sgml,v 1.2 2001/04/26 11:02:40 fukachan Exp $
+ $FML: fmlthread.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $
-->
<sect1 id="usage.fmlthread">
-
-<title> スレッドを表示する (fmlthread) </title>
+ <title>
+ スレッドを表示する (fmlthread)
+ </title>
<para>
fmlthread は引数にコマンドとML名をとります。
diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml
index 64829145..f90ceea4 100644
--- a/fml/doc/ja/tutorial/usage/makefml.sgml
+++ b/fml/doc/ja/tutorial/usage/makefml.sgml
@@ -1,10 +1,11 @@
<!--
- $FML: makefml.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $
+ $FML: makefml.sgml,v 1.3 2002/07/02 10:39:39 fukachan Exp $
-->
<sect1 id="usage.makefml">
-
-<title> makefml を使って、ユーザの登録/削除他(あらゆる:) </title>
+ <title>
+ makefml を使って、ユーザの登録/削除他(あらゆる:)
+ </title>
<para>
makefml の基本的な使い方は &fml4; の makefml と同様です。
@@ -46,28 +47,47 @@ makefml の基本的な使い方は &fml4; の makefml と同様です。
<listitem>
<para>
- MLの作成
+ アドレスの変更
(
- newml
- )
+ chaddr
+ )
</para>
</listitem>
<listitem>
<para>
- MLの削除
+ リモート管理者の登録
(
- rmml
+ addadmin
+ addpriv
+ )
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ リモート管理者の削除
+ (
+ byeadmin
+ byepriv
+ )
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ MLの作成
+ (
+ newml
)
</para>
</listitem>
<listitem>
<para>
- ファイルを送り返す
+ MLの削除
(
- get
- mget
+ rmml
)
</para>
</listitem>
diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml
index 7eff4588..8988f692 100644
--- a/fml/doc/ja/tutorial/usage/post.sgml
+++ b/fml/doc/ja/tutorial/usage/post.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: post.sgml,v 1.3 2002/04/01 23:41:07 fukachan Exp $
+ $FML: post.sgml,v 1.4 2002/07/05 04:01:37 fukachan Exp $
-->
<sect1 id="usage.post">
@@ -8,13 +8,15 @@
</title>
<para>
-elena MLなら、投稿する時はメールを elena@fml.org に送信してください。
+fml.org の elena MLへの投稿は、
+普通にメールを elena@fml.org に送信することです。
メールは MTA が受け、最終的に MTA は
/usr/local/libexec/fml/fml.pl
(もしくは /usr/local/libexec/fml/distribute )
というコマンドを実行します。
fml.pl はメールを標準入力から受けとり、
-MLとして必要な処理をした後、MTA へ配送を委ねます。
+MLとして必要な処理(記事の保存やヘッダの書き換え)をした後、
+MTA へ配送処理を委ねます。
</para>
@@ -33,6 +35,15 @@ Subject: [elena:00100] えれなさん素敵
</para>
<para>
+記事の保存(テキストファイル)
+</para>
+
+<para>
+HTML 化された記事を作る。
+~fml/public_html/ 以下に作成されます。
+</para>
+
+<para>
スレッド追跡システムのデータベースを更新
</para>