diff options
| author | fukachan <fukachan> | 2002-07-02 10:39:28 +0000 |
|---|---|---|
| committer | fukachan <fukachan> | 2002-07-02 10:39:28 +0000 |
| commit | b753b70a78a0ec9b5e82d37a8db6735ca59cfc4c (patch) | |
| tree | 706989986f84f0ef077a6616f520c61a8dee1606 /fml/doc | |
| parent | d5fb6f177372244aefa3b7156a97132959a4956d (diff) | |
| download | fml8-b753b70a78a0ec9b5e82d37a8db6735ca59cfc4c.tar.gz fml8-b753b70a78a0ec9b5e82d37a8db6735ca59cfc4c.tar.bz2 fml8-b753b70a78a0ec9b5e82d37a8db6735ca59cfc4c.zip | |
updated to sync w/ current
clean up the structure to catch up "fml bible" structure
Diffstat (limited to 'fml/doc')
34 files changed, 1029 insertions, 616 deletions
diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml index 54863c85..17c565e2 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.33 2002/04/01 23:41:00 fukachan Exp $ +$FML: book.sgml,v 1.34 2002/04/02 23:16:30 fukachan Exp $ --> <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [ @@ -35,21 +35,41 @@ $FML: book.sgml,v 1.33 2002/04/01 23:41:00 fukachan Exp $ </partintro> <!-- 以下、各章が並ぶ --> - &chapter.overview; - &chapter.download; - &chapter.install; + &chapter.overview.ml; + &chapter.overview.fml; </part> <part> - <title> 各論およびカスタマイズ </title> + <title> fml のセットアップ〜ＭＬの作成 </title> <partintro> <para> トピックスごとに、まとめます。 </para> </partintro> + &chapter.download; + + <!-- unix --> + &chapter.install.fml.unix; &chapter.usage.newml; + + <!-- 2000/nt --> + &chapter.install.fml.nt; + + <!-- misc around installation/setup --> + &chapter.upgrade; + </part> + + + <part> + <title> fml のカスタマイズ </title> + <partintro> + <para> + トピックスごとに、まとめます。 + </para> + </partintro> + &chapter.usage.post; &chapter.usage.command; &chapter.usage.onhost; 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> diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml index b43cf1b8..a7f7f041 100644 --- a/fml/doc/ja/tutorial/delivery/chapter.sgml +++ b/fml/doc/ja/tutorial/delivery/chapter.sgml @@ -1,16 +1,16 @@ <!-- - $FML: chapter.sgml,v 1.5 2002/02/16 10:08:34 fukachan Exp $ + $FML: chapter.sgml,v 1.6 2002/04/01 23:41:01 fukachan Exp $ --> <chapter id="delivery"> - - <TITLE> &fmldevel; のメール配送システム </TITLE> + <TITLE> + &fmldevel; のメール配送システム + </TITLE> <sect1 id="fml5-delivery"> - - <title> - &fml4; と &fmldevel; の相違点 - </title> + <title> + &fml4; と &fmldevel; の相違点 + </title> <para> &fmldevel; の最大の目的の一つは、メンバーリストの取得と操作の統合と抽 diff --git a/fml/doc/ja/tutorial/devel/create_program.sgml b/fml/doc/ja/tutorial/devel/create_program.sgml index 2b41dbb7..2dc90832 100644 --- a/fml/doc/ja/tutorial/devel/create_program.sgml +++ b/fml/doc/ja/tutorial/devel/create_program.sgml @@ -1,5 +1,5 @@ <!-- - $FML: create_program.sgml,v 1.2 2001/11/25 06:23:30 fukachan Exp $ + $FML: create_program.sgml,v 1.3 2002/04/01 23:41:01 fukachan Exp $ --> <chapter id="program.create"> @@ -21,12 +21,12 @@ </para> <para> -用意しなければいけない関数は +用意しなければいけない関数(メソッド)は FML::Process::Flow::ProcessStart() を見ると分かります。 FML::Process::Flow::ProcessStart() がプロセスを駆動しているからです。 -2001/11 現在、プロセスは以下のメソッドからなっています。 +2002/07 現在、これらのメソッドが必須です。 <screen> new() prepare() @@ -34,6 +34,7 @@ verify_request() run() finish() </screen> +ダミーでもよいので、このメソッドを用意しておいて下さい。 </para> <para> @@ -72,9 +73,6 @@ FML::Process::Switch total 11 -rw-r--r-- 1 fml wheel 4044 Nov 20 00:19 Standalone.pm lrwxr-xr-x 1 root wheel 6 Nov 23 22:10 command -> loader -drwxr-xr-x 4 root wheel 512 Mar 29 2001 current-20010329 -drwxr-xr-x 4 root wheel 512 Apr 7 2001 current-20010407 -drwxr-xr-x 4 root wheel 512 Apr 18 2001 current-20010418 drwxr-xr-x 3 root wheel 512 Nov 23 22:10 current-20011123 lrwxr-xr-x 1 root wheel 6 Nov 23 22:10 distribute -> loader lrwxr-xr-x 1 root wheel 6 Nov 23 22:10 fml.pl -> loader @@ -134,20 +132,33 @@ FML::CGI::○○○ の注意点は、 用意するメソッドは <screen> html_start() -run_cgi() html_end() </screen> +および +<screen> +run_cgi_main() +run_cgi_title() +run_cgi_navigator() +run_cgi_menu() +run_cgi_command_help() +run_cgi_options() +</screen> になるという点です。 -これは -FML::Process::CGI 以下で駆動される時に、 -run() メソッドが、 +これらの組で一つの画面が構成されています。 +</para> + +<para> +CGI プロセスは FML::Process::CGI で駆動され、run() メソッドは <screen> $curproc->html_start($args); -$curproc->run_cgi($args); +画面を作るために run_cgi_xxx() メソッド郡を呼び出す。 $curproc->html_end($args); </screen> -を呼び出しているからです。 -FML::Process::CGI::Kernel 自身は、 +のように FML::CGI:: 以下のメソッド群を呼び出しているからです。 +</para> + +<para> +ちなみに FML::Process::CGI::Kernel 自身は、 2001/11 現在、プロセスは以下のメソッド <footnote> <para> @@ -164,6 +175,8 @@ verify_request() run() finish() </screen> +特に、これらを編集する必要はないでしょう。 +ちなみに FML::CGI:: は run() から呼ばれています。 </para> </sect1> diff --git a/fml/doc/ja/tutorial/devel/docbook.sgml b/fml/doc/ja/tutorial/devel/docbook.sgml index 4b488f00..2c94e345 100644 --- a/fml/doc/ja/tutorial/devel/docbook.sgml +++ b/fml/doc/ja/tutorial/devel/docbook.sgml @@ -1,5 +1,5 @@ <!-- - $FML: docbook.sgml,v 1.2 2001/11/19 14:55:15 fukachan Exp $ + $FML: docbook.sgml,v 1.3 2002/04/01 23:41:01 fukachan Exp $ --> @@ -9,7 +9,7 @@ </title> <para> -fml-devel (fml 5.0) のドキュメントでは、SGML の DTD は +fml-devel (&fmldevel;) のドキュメントでは、SGML の DTD は <ulink url="http://www.oasis-open.org/docbook/"> DOCBOOK @@ -397,7 +397,7 @@ DTD と DSL の規格文書群は必須です。 </para> <para> -fml 5.0 では、以下のプログラムを使って HTML やテキストファイルを作成し +&fmldevel; では、以下のプログラムを使って HTML やテキストファイルを作成し ています。 <itemizedlist> @@ -427,7 +427,7 @@ fml 5.0 では、以下のプログラムを使って HTML やテキストファイルを作成し <para> もちろん sgmltools がなくても SGML から HTML を作ることができます。 どのツールを使うかは、あなたがどれを便利に思うか？次第です。 -単に &fml5; では、sgmltools を歴史的に使っているだけです。 +単に &fmldevel; では、sgmltools を歴史的に使っているだけです。 </para> <para> @@ -508,7 +508,7 @@ LISP を知らないとちょっと手が出ないでしょう。 </para> <para> -ちなみに fml 5.0 の DSL の記述は +ちなみに &fmldevel; の DSL の記述は <ulink url="../../../fml/doc/share/sgml/fml.dsl"> fml/doc/share/sgml/fml.dsl diff --git a/fml/doc/ja/tutorial/glossary.sgml b/fml/doc/ja/tutorial/glossary.sgml index 546b1a06..79653b17 100644 --- a/fml/doc/ja/tutorial/glossary.sgml +++ b/fml/doc/ja/tutorial/glossary.sgml @@ -1,5 +1,5 @@ <!-- - $FML: glossary.sgml,v 1.2 2001/11/19 14:55:15 fukachan Exp $ + $FML: glossary.sgml,v 1.3 2002/04/01 23:41:00 fukachan Exp $ --> <glossary id="glossary"> @@ -12,7 +12,7 @@ <glossterm> fml 4 </glossterm> <glossdef> <para> - fml 4.0 シリーズのこと + &fml4; シリーズのこと </para> </glossdef> @@ -20,16 +20,16 @@ <glossentry> - <glossterm> fml 5 / fml-devel </glossterm> + <glossterm> fml-devel </glossterm> <glossdef> <para> - 遠い将来に - fml 5.0 になるであろうとおもわれる fml-current + 将来 &fmldevel; になるであろうとおもわれる fml-current </para> <para> もしかしたら fml 8.x の方が適切かも知れない。 だが、まだ決まっていない。 + でも 8 じゃないかな〜という感じ濃厚 </para> </glossdef> @@ -41,7 +41,7 @@ <glossterm> curproc </glossterm> <glossdef> <para> - "current process"の略。 + "current process"の略。 </para> <para> @@ -56,10 +56,10 @@ <glossterm> PCB </glossterm> <glossdef> <para> - Process Control Block の略。 - そのプロセス固有の情報を含む。 - 現状 fml 内部でのコンテキスト切替などはないので、 - UNIX カーネルの PCB とは少し趣が異なります。 + Process Control Block の略。 + そのプロセス固有の情報を含む。 + 現状 fml 内部でのコンテキスト切替などはないので、 + UNIX カーネルの PCB とは少し趣が異なります。 </para> <para> @@ -74,7 +74,7 @@ <glossterm> config </glossterm> <glossdef> <para> - configuration の略 + configuration の略 </para> </glossdef> </glossentry> @@ -84,7 +84,7 @@ <glossterm> conf </glossterm> <glossdef> <para> - configuration の略 + configuration の略 </para> </glossdef> </glossentry> @@ -94,7 +94,7 @@ <glossterm> arg / args </glossterm> <glossdef> <para> - アーギュメントの略 + アーギュメント( argument )の略 </para> </glossdef> @@ -106,7 +106,7 @@ <glossterm> fh </glossterm> <glossdef> <para> - ファイルハンドル( file handle ) + ファイルハンドル( file handle ) </para> </glossdef> @@ -118,7 +118,7 @@ <glossterm> dh </glossterm> <glossdef> <para> - ディレクトリハンドル( directory handle ) + ディレクトリハンドル( directory handle ) </para> </glossdef> @@ -130,8 +130,8 @@ <glossterm> fp </glossterm> <glossdef> <para> - 関数へのポインタ( function pointer )。 - ただし perl では CODE リファレンスと呼ぶべき + 関数へのポインタ( function pointer )。 + ただし perl では CODE リファレンスと呼ぶべき </para> </glossdef> </glossentry> @@ -141,14 +141,16 @@ <glossterm> _なになに </glossterm> <glossdef> <para> - 慣習的にパッケージ、クラス、オブジェクト内部で使う - 変数や関数名に _ ではじまるキーワードを使う。 + 慣習的にパッケージ、クラス、オブジェクト内部で使う + 変数や関数名に _ ではじまるキーワードを使う。 </para> <para> つまり private ということ( - OO の厳密な意味で private method という意味か？などとは - つっこまないようにしたい:-) + ここで + OO の厳密な意味で private method という意味か？などとは + つっこまないようにされたい + :-) </para> </glossdef> </glossentry> @@ -158,10 +160,14 @@ <glossterm> rなになに </glossterm> <glossdef> <para> - r はリファレンスの略。 - これをハンガリアン記法と呼ぶ。 - 特別に強調したい場合に使うことがあるが、 - fml 内部では、あまり使っていない。 + r はリファレンスの略。 + これはハンガリアン記法と呼ばれている。 + </para> + + <para> + 型を特別に強調したい場合に使うことがあるが、 + fml 内部では、ほとんど使っていない。 + 適宜コメントを参照してください。 </para> </glossdef> </glossentry> @@ -171,7 +177,7 @@ <glossterm> STR </glossterm> <glossdef> <para> - 文字列 ( string ) の略 + 文字列 ( string ) の略 </para> </glossdef> @@ -182,7 +188,7 @@ <glossterm> 日本語コードの略称 </glossterm> <glossdef> <para> - JIS SJIS EUC などおなじみのもの… + JIS SJIS EUC などおなじみのもの… </para> </glossdef> </glossentry> @@ -192,8 +198,8 @@ <glossterm> 2 </glossterm> <glossdef> <para> - to と発音が一緒のため省略形としてよく使う。 - 類似品として 4 ( for の意味)もある + to と発音が一緒のため省略形としてよく使う。 + 類似品として 4 ( for の意味)もある </para> <para> 例: STR2EUC (STRing to EUC の略) @@ -210,8 +216,8 @@ $euc_string = STR2EUC($string); <glossterm> 4 </glossterm> <glossdef> <para> - for と発音が同じために用いる。 - 例はまだなし。 + for と発音が同じために用いる。 + 例はまだなし。 </para> </glossdef> </glossentry> diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent index 0dc51805..349b4e05 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.35 2002/04/02 23:16:31 fukachan Exp $ + $FML: chapters.ent,v 1.36 2002/05/13 14:16:36 fukachan Exp $ --> <!entity versin "1.1"> @@ -14,6 +14,7 @@ <!-- 画像 --> <!entity image.architecture SYSTEM "architecture.gif" ndata gif> +<!entity image.ml SYSTEM "ml.gif" ndata gif> <!-- メタレベル --> @@ -23,9 +24,15 @@ <!-- パート I: introduction 〜 インストール、テストまで --> -<!entity chapter.overview SYSTEM "overview/chapter.sgml"> +<!entity chapter.overview.fml SYSTEM "overview/fml.sgml"> +<!entity chapter.overview.ml SYSTEM "overview/ml.sgml"> <!entity chapter.download SYSTEM "overview/download.sgml"> -<!entity chapter.install SYSTEM "install/chapter.sgml"> + + +<!-- パート II: セットアップ --> +<!entity chapter.install.fml.unix SYSTEM "install/fml_on_unix.sgml"> +<!entity chapter.install.fml.nt SYSTEM "install/fml_on_nt.sgml"> +<!entity chapter.upgrade SYSTEM "install/upgrade.sgml"> <!-- パート II: 使い方の例とカスタマイズについて --> diff --git a/fml/doc/ja/tutorial/include/terms.sgml b/fml/doc/ja/tutorial/include/terms.sgml index c488e900..d97926be 100644 --- a/fml/doc/ja/tutorial/include/terms.sgml +++ b/fml/doc/ja/tutorial/include/terms.sgml @@ -1,5 +1,5 @@ <!-- - $FML: terms.sgml,v 1.1 2001/05/01 15:16:26 fukachan Exp $ + $FML: terms.sgml,v 1.2 2002/04/01 23:41:02 fukachan Exp $ --> <sect1 id="terms"> @@ -25,7 +25,7 @@ <varlistentry> <term> fml4 </term> <listitem> - <para> fml 4.0 シリーズのこと </para> + <para> &fml4; シリーズのこと </para> </listitem> </varlistentry> diff --git a/fml/doc/ja/tutorial/install/fml_on_nt.sgml b/fml/doc/ja/tutorial/install/fml_on_nt.sgml new file mode 100644 index 00000000..525836ac --- /dev/null +++ b/fml/doc/ja/tutorial/install/fml_on_nt.sgml @@ -0,0 +1,16 @@ +<!-- + $FML: chapter.sgml,v 1.11 2002/04/01 23:41:02 fukachan Exp $ +--> + +<chapter id="install.fml.nt"> + <title> + Microsft 2000/NT 上での fml のインストール + </title> + +<warning> +<para> +まだ、できません。 +</para> +</warning> + +</chapter> diff --git a/fml/doc/ja/tutorial/install/chapter.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml index 6f568eb1..7654a304 100644 --- a/fml/doc/ja/tutorial/install/chapter.sgml +++ b/fml/doc/ja/tutorial/install/fml_on_unix.sgml @@ -1,15 +1,15 @@ <!-- - $FML: chapter.sgml,v 1.10 2002/03/18 07:39:27 fukachan Exp $ + $FML: chapter.sgml,v 1.11 2002/04/01 23:41:02 fukachan Exp $ --> -<chapter id="install"> +<chapter id="install.fml.unix"> <title> - インストール + UNIX 上での fml のインストール </title> <!-- ====================================================== --> -<sect1 id="install.configure"> +<sect1 id="install.fml.unix.configure"> <title> 概要 </title> @@ -17,8 +17,11 @@ <para> configure (GNU autoconf) および make を実行して下さい。 +なお configure の前に、適宜、ユーザ fml とグループ fml を作ってください。 <screen> % su root +# groupadd fml +# useradd -g fml -m fml # ./configure # make install </screen> @@ -51,61 +54,105 @@ mandir ${prefix}/man </screen> また <screen> +fmlconfdir $sysconfidr/fml /usr/local/etc/fml mlspooldir /var/spool/ml /var/spool/ml fml_owner fml fml +fml_group fml fml +default_domain 推測する 推測する </screen> -これらの変数は、それぞれ +これらの変数は、configure の引数で上書きすることができます。 +これらのオプションは <screen> ---with-mlspooldir=DIR ---with-fml-owner=USER +configure --help </screen> -で上書きすることができます。 +で表示されます。 +<screen> + --without-warning run perl as perl without -w + --with-fmlconfdir=DIR use DIR instead of SYSCONFDIR/fml + --with-mlspooldir=DIR use DIR instead of /var/spool/ml + --with-fml-owner=USER use USER instead of fml + --with-fml-group=GROUP use GROUP instead of fml + --with-default-domain=DOMAIN use DOMAIN as the ML domain +</screen> + </para> <para> サンプル <screen> -# ./configure --sysconfdir=/etc/fml -creating cache ./config.cache -checking for perl... perl -checking for perl... /usr/local/bin/perl -checking whether optional useful commands are available -checking for cksum... /usr/bin/cksum -checking for md5... /usr/bin/md5 -checking for tar... /usr/bin/tar -checking for gzip... /usr/bin/gzip -checking for zcat... /usr/bin/zcat -checking for gunzip... /usr/bin/gunzip -checking for lha... no +# ./configure --with-fmlconfdir=/etc/fml +loading cache ./config.cache +checking for perl... (cached) perl +checking for perl... (cached) /usr/local/bin/perl +checking whether optional useful commands are available or not +checking for cksum... (cached) /usr/bin/cksum +checking for md5... (cached) /usr/bin/md5 +checking for ls... (cached) /bin/ls +checking for tar... (cached) /usr/bin/tar +checking for gzip... (cached) /usr/bin/gzip +checking for zcat... (cached) /usr/bin/zcat +checking for gunzip... (cached) /usr/bin/gunzip +checking for lha... (cached) /usr/pkg/bin/lha checking for ish... no -checking for bzip2... /usr/bin/bzip2 -checking for bunzip2... /usr/bin/bunzip2 -checking for uuencode... /usr/bin/uuencode -checking for compress... /usr/bin/compress -checking for sendmail... /usr/sbin/sendmail -checking for nkf... /usr/pkg/bin/nkf +checking for bzip2... (cached) /usr/bin/bzip2 +checking for bunzip2... (cached) /usr/bin/bunzip2 +checking for uuencode... (cached) /usr/bin/uuencode +checking for compress... (cached) /usr/bin/compress +checking for sendmail... (cached) /usr/sbin/sendmail +checking for newaliases... (cached) /usr/bin/newaliases +checking for postfix... (cached) /usr/sbin/postfix +checking for postalias... (cached) /usr/sbin/postalias +checking for postconf... (cached) /usr/sbin/postconf +checking for postmap... (cached) /usr/sbin/postmap +checking for nkf... (cached) /usr/pkg/bin/nkf checking for kakasi... no checking for namazu... no -checking for pgp... no +checking for pgp... (cached) /usr/pkg/bin/pgp checking for pgp5... no checking for pgpe... no checking for pgpk... no checking for pgps... no checking for pgpv... no checking for gpg... no +checking for less... (cached) /usr/bin/less +checking for more... (cached) /usr/bin/more +checking for w3m... (cached) /usr/pkg/bin/w3m updating cache ./config.cache creating ./config.status creating config.sh creating fml/etc/main.cf -creating fml/etc/paths.cf +creating fml/etc/default_config.cf.ja +creating fml/etc/site_default_config.cf creating fml/libexec/loader +creating fml/bin/fmlalias creating fml/bin/fmlconf creating fml/bin/fmldoc creating fml/bin/fmlhtmlify creating fml/bin/fmlsch creating fml/bin/fmlthread +creating fml/bin/fmlspool creating fml/bin/makefml +enabled perl -w + +fml has been configure with the following options: + + prefix: /usr/local + exec_prefix: ${prefix} + bindir: ${exec_prefix}/bin + sbindir: ${exec_prefix}/sbin + lib_dir: ${exec_prefix}/lib + libexec_dir: ${exec_prefix}/libexec + mandir: ${prefix}/man + datadir: ${prefix}/share + + fml process owner: fml + fml process group: fml + fmlconfdir: /etc/fml + mlspooldir: /var/spool/ml + default domain: home.fml.org + +Now you must run "make install". </screen> </para> @@ -140,19 +187,19 @@ creating fml/bin/makefml <tbody> <row> - <entry> /etc/fml </entry> + <entry> /usr/local/etc/fml </entry> <entry> - 基本設定ファイルを置く場所。 - ( fml 4 の /usr/local/fml/.fml や default_config.ph 相当) + 基本設定ファイルを置く場所。 + ( fml 4 の /usr/local/fml/.fml や default_config.ph 相当) - バージョンやライブラリの場所(ディレクトリ)などを指定する。 + バージョンやライブラリの場所(ディレクトリ)などを指定する。 </entry> </row> <row> <entry> /usr/local/libexec/fml </entry> <entry> - 実行ファイル ( fml 4 の /usr/local/fml ) + 実行ファイル ( fml 4 の /usr/local/fml ) </entry> </row> @@ -203,42 +250,5 @@ creating fml/bin/makefml <!-- ====================================================== --> -<sect1 id="upgrade"> - <title> - アップグレード - </title> - -<para> -単に、もう一度 -<link linkend="install">インストール</link> -して下さい。 -</para> - -<para> -インストール後、/etc/fml/main.cf の fml_version 行の日付を -最新のものにして下さい。 -ファイルをセーブした瞬間から新しい fml に切り替わります -(注: エディタで編集中は古い内容)。 -</para> -</sect1> - - -<sect1 id="downgrade"> - <title> - ダウングレード - </title> - -<para> -ソースのインストールし直しなどは必要ありません。 -/etc/fml/main.cf の編集だけです。 -</para> - -<para> -/etc/fml/main.cf の fml_verison をアップグレード前のものに -戻して下さい。 -</para> - -</sect1> - </chapter> diff --git a/fml/doc/ja/tutorial/install/upgrade.sgml b/fml/doc/ja/tutorial/install/upgrade.sgml new file mode 100644 index 00000000..e8ba1911 --- /dev/null +++ b/fml/doc/ja/tutorial/install/upgrade.sgml @@ -0,0 +1,48 @@ +<!-- + $FML$ +--> + +<chapter> + <title> + アップグレード/ダウングレード + </title> + +<sect1 id="upgrade"> + <title> + アップグレード + </title> + +<para> +単に、もう一度 +<link linkend="install.fml.unix">インストール</link> +して下さい。 +</para> + +<para> +インストール後、/etc/fml/main.cf の fml_version 行の日付を +最新のものにして下さい。 +ファイルをセーブした瞬間から新しい fml に切り替わります +(注: エディタで編集中は古い内容)。 +</para> +</sect1> + + +<sect1 id="downgrade"> + <title> + ダウングレード + </title> + +<para> +ソースのインストールし直しなどは必要ありません。 +/etc/fml/main.cf の編集だけです。 +</para> + +<para> +/etc/fml/main.cf の fml_verison をアップグレード前のものに +戻して下さい。 +</para> + +</sect1> + + +</chapter> diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml index 12f84adf..32434bfa 100644 --- a/fml/doc/ja/tutorial/internals/bootloader.sgml +++ b/fml/doc/ja/tutorial/internals/bootloader.sgml @@ -1,5 +1,5 @@ <!-- - $FML: bootloader.sgml,v 1.5 2002/03/18 13:34:36 fukachan Exp $ + $FML: bootloader.sgml,v 1.6 2002/04/01 23:41:03 fukachan Exp $ --> <chapter id="bootloader"> @@ -9,7 +9,7 @@ <para> -fml 5.0 にはインストールされている fml のバージョン依存性を考慮するた +&fmldevel; にはインストールされている fml のバージョン依存性を考慮するた めに、実行時には本章で述べるようなブートストラップの過程があります。 <screen> @@ -32,7 +32,7 @@ loader から次々と呼ばれていく様子は、例えば配送処理の場合、次のよう </para> <para> -libexec/loader は /etc/fml/main.cf を読みこみます。 +libexec/loader は /usr/local/etc/fml/main.cf を読みこみます。 fml_version 変数から使うべきライブラリのバージョンを決めます。 例えば fml_vesrion が current-20010501 となっていたら /usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといった @@ -73,11 +73,6 @@ FML::Process::Mead >-| | |-use-a ... その他 ... </screen> -=> -<ulink url="../../../fml/lib/FML/Process/programs.ja.html"> -FML::Process::それぞれのプログラムのモジュールについて -</ulink> - </para> </sect1> @@ -102,7 +97,7 @@ FML::Process::それぞれのプログラムのモジュールについて <itemizedlist> <listitem> <para> - /etc/fml/main.cf を読み込む。 + /usr/local/etc/fml/main.cf を読み込む。 読み込むと fml のバージョンが分かる。 default_config.cf はバージョン依存であるので、 ここでまずバージョンを評価しなければいけないことに注意。 diff --git a/fml/doc/ja/tutorial/internals/cgi.sgml b/fml/doc/ja/tutorial/internals/cgi.sgml index fe084a32..681964d6 100644 --- a/fml/doc/ja/tutorial/internals/cgi.sgml +++ b/fml/doc/ja/tutorial/internals/cgi.sgml @@ -1,5 +1,5 @@ <!-- - $FML: cgi.sgml,v 1.4 2002/03/19 04:48:54 fukachan Exp $ + $FML: cgi.sgml,v 1.5 2002/04/01 23:41:03 fukachan Exp $ --> <chapter id="internal.cgi"> @@ -17,7 +17,12 @@ FML::CGI のクラスは以下の３つのメソッドを実装して下さい。 <screen> html_start() -run_cgi() +run_cgi_main() +run_cgi_title() +run_cgi_navigator() +run_cgi_menu() +run_cgi_command_help() +run_cgi_options() html_end() </screen> ここで @@ -32,7 +37,7 @@ run_cgi() メソッドでは BODY の部分を表示してください。 $curproc の run() メソッドは <screen> html_start() -run_cgi() +run_cgi_XXX() 群を実行(テーブル状に出力を配置する) html_end() </screen> を順番に実行しています。 @@ -43,7 +48,7 @@ prepare() verify_request() run() html_start() - run_cgi() + run_cgi_○○() html_end() finish() </screen> diff --git a/fml/doc/ja/tutorial/internals/config.cf.sgml b/fml/doc/ja/tutorial/internals/config.cf.sgml index 80459a83..f855a0df 100644 --- a/fml/doc/ja/tutorial/internals/config.cf.sgml +++ b/fml/doc/ja/tutorial/internals/config.cf.sgml @@ -1,5 +1,5 @@ <!-- - $FML: config.cf.sgml,v 1.5 2001/11/24 06:54:46 fukachan Exp $ + $FML: config.cf.sgml,v 1.6 2002/04/01 23:41:03 fukachan Exp $ --> <chapter> @@ -12,7 +12,7 @@ <para> 各ＭＬごとにさまざまなカスタマイズをすることができます。 -この点は &fml4; でも &fml5; でも同様です。 +この点は &fml4; でも &fmldevel; でも同様です。 </para> <para> @@ -24,11 +24,9 @@ <para> この perl script 方式にはいくつか問題があります。 例えば perl script なので、perl が許す限りの自由な書き方ができます。 -これは config.ph の最大の問題です。 +これは人間にとっては嬉しいのですが、 +機械処理の観点からは問題です。というのは makefml や CGI をはじめとする設定インターフェイスを書きにくいのです。 -</para> - -<para> そこで &fml4; では、 cf というファイルと config.ph という 2 つのフォーマットの異なるファイルが使われています。 @@ -37,8 +35,8 @@ cf というファイルと config.ph という <para> しかし、これはこれで２つのファイルに分かれてしまう点が 保守しにくさを生みます。 -よって &fml5; では、設定インターフェイスにやさしい -新フォーマットを提唱します。 +よって &fmldevel; では、 +設定インターフェイスにやさしい新フォーマットを提唱します。 それが config.cf です。 これは本質的に postfix 風のフォーマットです。 </para> diff --git a/fml/doc/ja/tutorial/internals/design.sgml b/fml/doc/ja/tutorial/internals/design.sgml index 694365b2..9c51afb2 100644 --- a/fml/doc/ja/tutorial/internals/design.sgml +++ b/fml/doc/ja/tutorial/internals/design.sgml @@ -1,5 +1,5 @@ <!-- - $FML: design.sgml,v 1.5 2002/02/16 10:08:35 fukachan Exp $ + $FML: design.sgml,v 1.6 2002/04/01 23:41:03 fukachan Exp $ --> <chapter id="design"> @@ -21,8 +21,8 @@ <ulink url="http://www.fml.org/devel/"> fml-devel </ulink> -とも呼ばれている fml 5.0 プロジェクトは、 -fml 4.0 の再構想(refactoring)とその実装(例)の構築 +とも呼ばれている &fmldevel; プロジェクトは、 +&fml4; の再構想(refactoring)とその実装(例)の構築 を行なっています。 </PARA> @@ -35,8 +35,8 @@ http://www.fml.org/devel/ <para> -現状の fml-devel は fml 5.0 のアイデアを募るための、 -fml 5.0 のアルファ版のアルファ版のアルファ版 +現状の fml-devel は &fmldevel; のアイデアを募るための、 +&fmldevel; のアルファ版のアルファ版のアルファ版 もしくは プロトタイプ とでもいうべきものです。ですが、すでに動く実装例をダウンロードできます @@ -51,7 +51,7 @@ fml 5.0 のアルファ版のアルファ版のアルファ版 </PARA> <para> -ものによっては fml 5.0 用に作られたモジュールを fml 4.0 へ +ものによっては &fmldevel; 用に作られたモジュールを &fml4; へ 輸入/輸出することも検討しています。 たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)などは その良い例だろうし、新機能を提供するモジュールなども再輸入(輸出)可能な @@ -59,12 +59,12 @@ fml 5.0 のアルファ版のアルファ版のアルファ版 </PARA> <para> -これらのマージおよび 4.0 自体のコードの保守をしつつ 4.0 および 5.0 は +これらのマージおよび 4.0 自体のコードの保守をしつつ 4.0 および &fmldevel; は 並行開発されていく予定です。 そのため 4.0 系は stable に近い current という位置付けになります。 そして 4.0 の bug fix は 4.0.x (4.0.1 4.0.2 …)としてまとめられリリー スれていく予定です。 -逆に 5.0 は本当の開発用のコード( fml-current )ということになります。 +逆に &fmldevel; は本当の開発用のコード( fml-current )ということになります。 </PARA> </sect1> @@ -86,7 +86,7 @@ fml 5.0 のアルファ版のアルファ版のアルファ版 <listitem> <para> - 全部 perl module 形式 (要 5.004 以降) + 全部 perl module 形式 (要 &fmldevel;04 以降) </para> </listitem> diff --git a/fml/doc/ja/tutorial/internals/list.variables.sgml b/fml/doc/ja/tutorial/internals/list.variables.sgml index 853f7925..298459c9 100644 --- a/fml/doc/ja/tutorial/internals/list.variables.sgml +++ b/fml/doc/ja/tutorial/internals/list.variables.sgml @@ -712,6 +712,15 @@ admin </row> <row> <entry> +qmail_virtual_map_file</entry> +<entry> + MTA に教えるための virtual map ファイル(テンプレート)</entry> +<entry> +$domain_qmail_config_dir/virtualdomains + </entry> +</row> +<row> +<entry> qmail_virtualdomains_file</entry> <entry> virtual domain configurations for qmail</entry> diff --git a/fml/doc/ja/tutorial/internals/main.cf.sgml b/fml/doc/ja/tutorial/internals/main.cf.sgml index 4025ea5a..557368c2 100644 --- a/fml/doc/ja/tutorial/internals/main.cf.sgml +++ b/fml/doc/ja/tutorial/internals/main.cf.sgml @@ -1,73 +1,88 @@ <!-- - $FML: main.cf.sgml,v 1.2 2001/05/10 03:11:43 fukachan Exp $ + $FML: main.cf.sgml,v 1.3 2002/04/01 23:41:03 fukachan Exp $ --> <sect1 id="main.cf"> -<title> /etc/fml/main.cf </title> + <title> + /etc/fml/main.cf + </title> <para> /etc/fml/main.cf は各ＭＬの設定ではありません。 -これは、バージョン依存性を解決するための設定ファイルです。 -fml のプログラム群が起動する時に参照します。 +これは、fml のバージョンなどメタレベルの依存性を解決するための設定ファ +イルで、fml のプログラム群が起動する時に参照します。 </para> <para> -main.cf はこのようなファイルです。 - -フォーマットは +main.cf のフォーマットは他の .cf と同様 +<footnote> +<para> +実際のところファイル拡張子とファイルフォーマットには相関があります。 +</para> +</footnote> +に <screen> 変数名 = 値 </screen> です。 <screen> +# +# $FML: main.cf.in,v 1.12 2002/04/01 23:41:09 fukachan Exp $ +# + # fml version # This is important # Example: fml 5.0 # fml-current YYYYMMDD # fml-devel YYYYMMDD -fml_version = current-20010423 +fml_version = current-20020701 + +fml_owner = fml + +fml_group = fml ### ### DIRECTORIES ### +# Example: /usr/local +prefix = /usr/local +exec_prefix = ${prefix} # $config_dir holds the global main configuration and # several version-dependent default configurations # Example: /etc/fml -config_dir = /etc/fml +config_dir = /etc/fml # Example: /etc/fml/defaults/$fml_version -default_config_dir = $config_dir/defaults/$fml_version - -# Example: /usr/local -default_prefix = /usr/local - +default_config_dir = $config_dir/defaults/$fml_version +# defined for convenience, for example, we need this variable +# at include, include-ctl, which needs expansion of ../libexec/fml/fml.pl # Example: /usr/local/libexec/fml -libexec_prefix = $default_prefix - -# Example: /usr/local/lib/fml -lib_prefix = $default_prefix +executable_prefix = ${exec_prefix}/libexec/fml # Example: /usr/local/libexec/fml/$fml_version -libexec_dir = $libexec_prefix/libexec/fml/$fml_version +libexec_dir = ${exec_prefix}/libexec/fml/$fml_version # Example: /usr/local/lib/fml/$fml_version -lib_dir = $lib_prefix/lib/fml/$fml_version +lib_dir = ${exec_prefix}/lib/fml/$fml_version + +# Example: /usr/local/share/fml/$fml_version +share_dir = ${prefix}/share/fml/$fml_version # site local library location # which is prepared but not used by fml itself -local_lib_dir = $default_prefix/lib/fml/site_local +local_lib_dir = ${exec_prefix}/lib/fml/site_local # ml's home directories # $ml_home_dir (e.g. /var/spool/ml/elena ) is taken from loader's @ARGV. # This is compatible with fml 4.0. # Example: /var/spool/ml -ml_home_prefix = /var/spool/ml +default_ml_home_prefix = /var/spool/ml @@ -77,18 +92,26 @@ ml_home_prefix = /var/spool/ml # default domain -default_domain = fml.org +default_domain = fml.org # version dependent default_config.cf location # whic holds # Example: /etc/fml/defaults/5.0/default_config.cf -default_config = $config_dir/defaults/$fml_version/default_config.cf +default_config_cf = $default_config_dir/default_config.cf # domain specific configurations # Example: /etc/fml/domains/fml.org/default_config.cf -domain_default_config = $config_dir/domains/$default_domain/config.cf +domain_default_config = $config_dir/domains/$default_domain/config.cf + + +# virtual format: domain directory +# for example, +# fml.org /var/spool/ml/fml.org +# nuinui.net /var/spool/ml/nuinui.net +virtual_maps = $config_dir/virtual + </screen> </para> </sect1> diff --git a/fml/doc/ja/tutorial/internals/style.sgml b/fml/doc/ja/tutorial/internals/style.sgml index 29aaa547..8459dcbf 100644 --- a/fml/doc/ja/tutorial/internals/style.sgml +++ b/fml/doc/ja/tutorial/internals/style.sgml @@ -1,10 +1,11 @@ <!-- - $FML: style.sgml,v 1.3 2002/04/01 23:41:04 fukachan Exp $ + $FML: style.sgml,v 1.4 2002/05/27 09:00:28 fukachan Exp $ --> <chapter id="programingstyle"> - -<TITLE>プログラミング・スタイル</TITLE> + <TITLE> + プログラミング・スタイル + </TITLE> <para> ここでは、プログラミング上のいくつかの諸問題についてまとめます。 @@ -86,10 +87,16 @@ use_変数 = yes/no <!-- ==================================================== --> <sect1> + <title> + プログラミング・スタイル (原案のメモ(注: 単なる走り書き)) + </title> + +<warning> +<para> +ログとして、原案のメモ(注: 単なる走り書き)をここに記録しておきます。 +</para> +</warning> -<title> -プログラミング・スタイル (原案のメモ(注: 単なる走り書き)) -</title> <para> <itemizedlist> diff --git a/fml/doc/ja/tutorial/message/discussion.sgml b/fml/doc/ja/tutorial/message/discussion.sgml index 67ac83c4..dd7112a0 100644 --- a/fml/doc/ja/tutorial/message/discussion.sgml +++ b/fml/doc/ja/tutorial/message/discussion.sgml @@ -1,5 +1,5 @@ <!-- - $FML: discussion.sgml,v 1.1 2001/11/24 12:48:10 fukachan Exp $ + $FML: discussion.sgml,v 1.2 2002/04/01 23:41:04 fukachan Exp $ --> <sect1> @@ -14,10 +14,10 @@ <!-- ===================================================== --> <sect2> - <title> fml 4.0 の場合 </title> + <title> &fml4; の場合 </title> <para> -fml 4.0 では +&fml4; では <screen> Mesg(*e, キーワード, デフォルトのメッセージ, 変換に使う引数); </screen> @@ -45,7 +45,7 @@ fml 4.0 では <!-- ===================================================== --> <sect2> - <title> fml 5.0 はどうするべきか？ </title> + <title> &fmldevel; はどうするべきか？ </title> <para> 一つのファイルに一つのキーワードを持つのと、 @@ -85,7 +85,7 @@ locale の定義ファイル( <sect3> <title> - fml 5.0: とりあえずの方針 + &fmldevel;: とりあえずの方針 </title> <para> diff --git a/fml/doc/ja/tutorial/module/IO::Adapter.sgml b/fml/doc/ja/tutorial/module/IO::Adapter.sgml index 9e866b72..f2233c93 100644 --- a/fml/doc/ja/tutorial/module/IO::Adapter.sgml +++ b/fml/doc/ja/tutorial/module/IO::Adapter.sgml @@ -1,5 +1,5 @@ <!-- - $FML: IO::Adapter.sgml,v 1.2 2001/11/24 03:22:56 fukachan Exp $ + $FML: IO::Adapter.sgml,v 1.3 2002/04/01 23:41:05 fukachan Exp $ --> <chapter id="module.io.adapter"> @@ -13,7 +13,7 @@ </title> <para> -fml 5.0 でのメンバーリストの読み書きは +&fmldevel; でのメンバーリストの読み書きは IO::Adapter という抽象クラスを通じて、 アドレスの登録/削除を行なうようになっています。 </para> diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml deleted file mode 100644 index 8f3fb5aa..00000000 --- a/fml/doc/ja/tutorial/overview/chapter.sgml +++ /dev/null @@ -1,198 +0,0 @@ -<!-- - $FML: chapter.sgml,v 1.9 2002/03/18 07:39:58 fukachan Exp $ ---> - -<chapter id="overview"> - <title> - &fmldevel; の概要 - </title> - -<important> - -<para> -&fmldevel; は &fml4; 相当のものを完全に一から書き直すプロジェクトです。 -使い方の見かけは &fml4; に"似せて"います。 -主な注意点は -root での作業、 configure の使用、 -そして /etc/fml/ 以下のファイル、 -特に /etc/fml/main.cf というグローバルな設定ファイルです。 -</para> - -</important> - -<sect1> - <title> - インストール作業の概略 - </title> - -<para> -以下で、特に触れていない概念(例: ＭＬとは？)については &fml4; と同様です。 -くわしくは &fml4; の資料( - <ulink url="http://www.fml.org/fml/"> - http://www.fml.org/fml/ - </ulink> - や - &fmlbible; -)を適宜、参照して下さい。 -</para> - -<para> -さて、いつものように elena ＭＬの作成過程を例にとりましょう。 -インストールのおおまかな流れは次のようになります。 -</para> - - -<orderedlist> - <listitem> - <para> - <link linkend="download"> - ソースをダウンロードして、展開して下さい。 - </link> - </para> - </listitem> - - <listitem> - <para> - <link linkend="install"> - ユーザ root でインストールをする。 - まず、ユーザ fml とグループ fml を作成し、 - <link linkend="install.configure"> - configure - </link> - および make を実行して下さい。 - </link> -<screen> -% su root -# groupadd fml -# useradd -m -g fml fml -# ./configure -# make install -</screen> - </para> - - <para> - (デフォルトでは)インストーラは /usr/local/bin - <footnote> - <para> - デフォルトでは /usr/local ディレクトリ以下に - 適宜サブディレクトリが作られます。 - <link linkend="install.configure"> - configure のオプション - </link> - で変更が可能です。 - </para> - </footnote> - に - fmldoc fmlconf fmlthread makefml fmlhtmlify fmlsch - などをインストールします。 - 実は、 - これらは - /usr/local/libexec/fml の下の実体を呼び出す単なる - wrapper です。 - </para> - </listitem> - - - <listitem> - <para> - <link linkend="guide.newml"> - ユーザ fml で elena ＭＬを作る。 - </link> -<screen> -% su fml -% makefml newml elena -</screen> - </para> - </listitem> - - - <listitem> - <para> - MTA から fml を起動するために - /etc/mail/aliases の設定などをしてください。 - </para> - </listitem> - - - <listitem> - <para> - ＭＬ の動作テストをしてください。 - </para> - </listitem> - - - <listitem> - <para> - <link linkend="guide.config.cf"> - ＭＬ のカスタマイズをする。 - </link> - </para> - </listitem> - -</orderedlist> - -<warning> -<para> -&fml4; と異なり root でインストールすることに注意して下さい。 -</para> -</warning> - -</sect1> - - -<!-- ============================================================= --> -<sect1 id="guide.newml"> - - <title> ＭＬを作る </title> - -<para> -makefml を使ってＭＬを作成します。 -(デフォルトドメインの場合) makefml 使い方は &fml4; の時と同様です。 -<screen> -% su fml -% makefml newml elena -</screen> -詳しくは -<link linkend="usage.newml"> -<xref linkend="usage.newml"> -</link> -を参照してください。 -</para> - -</sect1> - - -<sect1 id="guide.config.cf"> - <title> - カスタマイズをする - </title> - -<para> -elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集 -して下さい。 -フォーマットは postfix の設定ファイルと同様というとわかりやすいでしょう。 -(&fml4; の config.ph よりは cf にやや近いですが) -</para> - -<para> -適宜必要な項目だけを追加して下さい。 -指定しない場合はデフォルト値が使われます。 -デフォルト値はインストールしたバージョンに依存しており、 -<screen> -/etc/fml/defaults/バージョン番号/default_config.cf -</screen> -というファイル中で定義されています。 -これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように -バージョン番号付のディレクトリに置かれるのと似ています。 -</para> - -<para> -また、ライブラリなどのインストール先も fml のバージョンごとに -別のディレクトリになっていることに注意して下さい。 -この仕組みのおかげでアップグレードしても元に戻すのが簡単です。 -これは &fml5; の特徴です。 -</para> - -</sect1> - -</chapter> diff --git a/fml/doc/ja/tutorial/overview/download.sgml b/fml/doc/ja/tutorial/overview/download.sgml index 49515bbe..a325dd5d 100644 --- a/fml/doc/ja/tutorial/overview/download.sgml +++ b/fml/doc/ja/tutorial/overview/download.sgml @@ -1,16 +1,18 @@ <!-- - $FML: download.sgml,v 1.3 2001/11/19 14:55:17 fukachan Exp $ + $FML: download.sgml,v 1.4 2001/11/23 15:00:48 fukachan Exp $ --> <chapter id="download"> - -<title> fml-devel のソースの入手方法 </title> + <title> + &fmldevel; のソースコードをダウンロードする + </title> <!-- ==================================================== --> <sect1 id="ftp.fml.org"> - -<title> ftp </title> + <title> + ftp サーバからダウンロードする。 + </title> <para> fml-devel のソースは @@ -39,11 +41,12 @@ ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/ <!-- ==================================================== --> <sect1 id="anoncvs"> - -<title> cvs へのアクセス </title> + <title> + cvs へのアクセス + </title> <para> -anoncvs.fml.org の fmlsrc 以下が fml 5.0 ブランチです。 +anoncvs.fml.org の fmlsrc 以下が &fmldevel; ブランチです。 </para> <para> @@ -59,8 +62,9 @@ cvs -d cvs.fml.org:/cvsroot co fmlsrc <!-- ==================================================== --> <sect1 id="cvsweb"> - -<title> cvsweb による cvs へのアクセス </title> + <title> + cvsweb による cvs へのアクセス + </title> <para> <ulink url="http://www.fml.org/cvsweb/fmlsrc/"> diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml new file mode 100644 index 00000000..ba562d77 --- /dev/null +++ b/fml/doc/ja/tutorial/overview/fml.sgml @@ -0,0 +1,371 @@ +<!-- + $FML: chapter.sgml,v 1.10 2002/04/01 23:41:06 fukachan Exp $ +--> + +<chapter id="overview"> + <title> + &fmldevel; の概要 + </title> + +<important> + +<para> +&fmldevel; は &fml4; 相当のものを完全に一から書き直すプロジェクトです。 +使い方の見かけは &fml4; に"似せて"います。 +主な注意点は +root での作業、 +configure の使用、 +そして /usr/local/etc/fml/ 以下のファイル、 +特に /usr/local/etc/fml/main.cf というグローバルな設定ファイルの編集です。 +</para> + +</important> + + +<!-- ======================================================== --> +<sect1> + <title> + &fmldevel; でできること + </title> + +<para> +&fml4; の再実装にあたっての山場はすでに越えたと思います。 +でも、こまごまとしたものはいろいろと残っていますが… +</para> + +<para> + + <itemizedlist> + + + <listitem> + <para> + postfix スタイルの設定ファイル + </para> + </listitem> + + + <listitem> + <para> + 配送、 + ヘッダの書き換え、 + フィルタ( 4.0 の Envelope Filter に相当するもの ) + </para> + </listitem> + + <listitem> + <para> + MTA が起動するメインのプログラム: + fml.pl distribute command + </para> + </listitem> + + + <listitem> + <para> + いくつかのユーティリティ: + fmlconf + fmldoc + fmlhtmlify + fmlsch + fmlthread + fmlspool + makefml + </para> + </listitem> + + + <listitem> + <para> + CGI : + fmlsch.cgi + fmlthread.cgi + makefml.cgi + </para> + </listitem> + + + <listitem> + <para> + IPv6 による配送 + </para> + </listitem> + + + <listitem> + <para> + スレッド追跡システム(CUI と CGI を含む): + (fmlthread fmlthread.cgi) + </para> + </listitem> + + + <listitem> + <para> + 記事の HTML 化システム: + fmlhtmlify および makefml に HTML 化コマンドがあります。 + </para> + </listitem> + + + <listitem> + <para> + <link linkend="module.io.adapter"> + 抽象化 IO 層 + </link> + メンバーファイルをファイル、/etc/group, NIS, MySQL + から取り出すことができます。 + </para> + </listitem> + </itemizedlist> +</para> + +</sect1> + + +<!-- ======================================================== --> +<sect1> + <title> + インストール作業の概略 + </title> + +<para> +以下で、特に触れていない概念(例: ＭＬとは？)については &fml4; と同様です。 +くわしくは &fml4; の資料( + <ulink url="http://www.fml.org/fml/"> + http://www.fml.org/fml/ + </ulink> + や + &fmlbible; +)を適宜、参照して下さい。 +</para> + +<para> +さて、いつものように elena ＭＬの作成過程を例にとりましょう。 +インストールのおおまかな流れは次のようになります。 +</para> + + +<orderedlist> + <listitem> + <para> + <link linkend="download"> + ソースをダウンロードして、展開して下さい。 + </link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="install.fml.unix"> + ユーザ root でインストールをする。 + まず、ユーザ fml とグループ fml を作成し、 + <link linkend="install.fml.unix.configure"> + configure + </link> + および make を実行して下さい。 + </link> +<screen> +% su root +# groupadd fml +# useradd -m -g fml fml +# ./configure +# make install +</screen> + </para> + + <para> + (デフォルトでは)インストーラは /usr/local/bin + <footnote> + <para> + デフォルトでは /usr/local ディレクトリ以下に + 適宜サブディレクトリが作られます。 + <link linkend="install.fml.unix.configure"> + configure のオプション + </link> + で変更が可能です。 + </para> + </footnote> + に + fmldoc fmlconf fmlthread makefml fmlhtmlify fmlsch + などをインストールします。 + 実は、 + これらは + /usr/local/libexec/fml の下の実体を呼び出す単なる + wrapper です。 + </para> + </listitem> + + + <listitem> + <para> + <link linkend="guide.newml"> + ユーザ fml で elena ＭＬを作る。 + </link> +<screen> +% su fml +% makefml newml elena +</screen> + </para> + </listitem> + + + <listitem> + <para> + MTA から fml を起動するために + MTA の設定をしてください。 + </para> + </listitem> + + + <listitem> + <para> + ＭＬ の動作テストをしてください。 + </para> + </listitem> + + + <listitem> + <para> + <link linkend="guide.config.cf"> + ＭＬ のカスタマイズをする。 + </link> + </para> + </listitem> + +</orderedlist> + +<warning> +<para> +&fml4; と異なり root でインストールすることに注意して下さい。 +</para> +</warning> + +</sect1> + + +<!-- ============================================================= --> +<sect1 id="guide.newml"> + + <title> ＭＬを作る </title> + +<para> +makefml を使ってＭＬを作成します。 +デフォルトのドメイン(例: fml.org)の場合、 +makefml 使い方は &fml4; の時と同様です。 +elena@fml.org ＭＬを作るには +<screen> +% su fml +% makefml newml elena +</screen> +とします。 +詳しくは +<link linkend="usage.newml"> +<xref linkend="usage.newml"> +</link> +を参照してください。 +</para> + +<para> +一方、バーチャルドメイン(nuinui.net)の場合は、 +アドレスを全部指定して下さい。 +elena@nuinui.net を作る場合は、次のように実行して下さい。 +<screen> +% su fml +% makefml newml elena@nuinui.net +</screen> +</para> + +</sect1> + + +<!-- ============================================================= --> +<sect1 id="guide.subscribe"> + + <title> ＭＬのメンバーを登録する </title> + +<para> +デフォルトのドメイン(例: fml.org)の場合は、 +<screen> +% su fml +% makefml subscribe elena rudo@nuinui.net +</screen> +で構いません。 +一方、バーチャルドメイン(nuinui.net)の場合は、 +アドレスを全部指定して下さい。 +<screen> +% su fml +% makefml subscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp +</screen> +</para> + +</sect1> + + +<!-- ============================================================= --> +<sect1 id="guide.unsubscribe"> + + <title> ＭＬのメンバーから削除する </title> + +<para> +デフォルトのドメイン(例: fml.org)の場合は、 +<screen> +% su fml +% makefml unsubscribe elena rudo@nuinui.net +</screen> +で構いません。 +一方、バーチャルドメイン(nuinui.net)の場合は、 +アドレスを全部指定して下さい。 +<screen> +% su fml +% makefml unsubscribe elena@nuinui.net fukachan@sapporo.iij.ad.jp +</screen> +</para> + +</sect1> + + +<!-- ============================================================= --> +<sect1 id="guide.config.cf"> + <title> + ＭＬの設定をカスタマイズをする + </title> + +<warning> +<para> +まだ makefml config は使えません。ごめんなさい。 +ファイルを手で編集して下さい。 +</para> +</warning> + + +<para> +elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集 +して下さい。 +フォーマットは postfix の設定ファイルと同様というとわかりやすいでしょう。 +(&fml4; の config.ph よりは cf にやや近いですが) +</para> + +<para> +適宜必要な項目だけを追加して下さい。 +指定しない場合はデフォルト値が使われます。 +デフォルト値はインストールしたバージョンに依存しており、 +<screen> +/usr/local/etc/fml/defaults/バージョン番号/default_config.cf +</screen> +というファイル中で定義されています。 +これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように +バージョン番号付のディレクトリに置かれるのと似ています。 +</para> + +<para> +また、ライブラリなどのインストール先も fml のバージョンごとに +別のディレクトリになっていることに注意して下さい。 +この仕組みのおかげでアップグレードしても元に戻すのが簡単です。 +これは &fmldevel; の特徴です。 +</para> + +</sect1> + + +</chapter> diff --git a/fml/doc/ja/tutorial/overview/ml.sgml b/fml/doc/ja/tutorial/overview/ml.sgml new file mode 100644 index 00000000..cdaf0685 --- /dev/null +++ b/fml/doc/ja/tutorial/overview/ml.sgml @@ -0,0 +1,68 @@ +<!-- + $FML: chapter.sgml,v 1.10 2002/04/01 23:41:06 fukachan Exp $ +--> + +<chapter id="overview.ml"> + <title> + ＭＬとは？ + </title> + +<sect1> + <title> + 電子メール + </title> + +<para> +電子メールとは、郵便のネットワーク版です。 +</para> + +<para> +見栄えはメールソフトによって変わりますが、メールサーバがやりとりしてい +るのは次のような形式のテキストのファイルに過ぎません。 +<screen> +From: rudo@nuinui.net +To: kenken@nuinui.net +Subject: あそぼうよ + +やは、けんけん。ぼく、るどだよ。 + +// るど +</screen> +</para> + +</sect1> + + + +<sect1> + <title> + メーリングリスト(ＭＬ) + </title> + +<para> +メーリングリスト(以下ＭＬ)とは、巨大な文通の仕組みのようなものです。 +</para> + +<para> +ただ、電子メールはいくらでもコピーできるので、 +仮想のある人(ＭＬのアドレス)にメールを送ると、 +文通友の会のメンバー全員にそのメールのコピーを配ります。 +これがＭＬの仕組みです。 +</para> + +</sect1> + + +<sect1> + <title> + ＭＬドライバのモデル + </title> + +<para> +ＭＬドライバのモデルは次のようなものです。 +<graphic entityref="image.ml"></graphic> +</para> + +</sect1> + +</chapter> diff --git a/fml/doc/ja/tutorial/policy.sgml b/fml/doc/ja/tutorial/policy.sgml index 051a2025..8b2a2ba6 100644 --- a/fml/doc/ja/tutorial/policy.sgml +++ b/fml/doc/ja/tutorial/policy.sgml @@ -1,5 +1,5 @@ <!-- - $FML: policy.sgml,v 1.1 2002/02/13 13:51:51 fukachan Exp $ + $FML: policy.sgml,v 1.2 2002/04/01 23:41:00 fukachan Exp $ --> <chapter id="design.policy"> @@ -7,6 +7,15 @@ デザイン/コーディングスタイルの上でいろいろ </title> +<warning> +<para> +スタイルについては、 +<ulink url="http://www.fml.org/software/FNF/">FNF</ulink> +も参照して下さい。 +</para> +</warning> + + <sect1> <title> ２、３の注意点 @@ -21,7 +30,15 @@ <para> オブジェクトの中身のキーを直接使わずに、 常にアクセスメソッドを定義すること。 -例: main_cf へのアクセス +例: main_cf へのアクセスは +<screen> +$curproc->{ ... }->{ main_cf } +</screen> +ではなく +<screen> +$curproc->main_cf(); +</screen> +を使うこと </para> diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml index 253d816c..38c7bad2 100644 --- a/fml/doc/ja/tutorial/preface.sgml +++ b/fml/doc/ja/tutorial/preface.sgml @@ -1,5 +1,5 @@ <!-- - $FML: preface.sgml,v 1.14 2002/04/13 10:59:02 fukachan Exp $ + $FML: preface.sgml,v 1.15 2002/05/13 14:18:15 fukachan Exp $ --> @@ -17,13 +17,16 @@ <warning> <para> -現状の &fml5; は運用ベースの実証実験の段階に入りました。 -基本的な機能はかなり実装されました。 -4.0 の細かな部分までフォローできているわけではありませんが… +現状の &fmldevel; は運用ベースの実証実験の段階に入り、 +config.cf の編集支援ツール(makefml config や CGI からの設定変更)を +除いて基本的な機能は実装されています。 +ＭＬごとに細かい設定変更をしたい場合を除けば、普通に使えます。 +実際使っています。 </para> <para> -その意味で、いろいろな機能を使いたい場合には、まだまだ +ただ 4.0 の細かい昨日まで実装されているわけではありません。 +その意味では、いろいろな機能を使いたい人は <ulink url="http://www.fml.org/software/fml/menu.html"> 4.0 stable </ulink> @@ -50,12 +53,12 @@ http://www.fml.org/software/fml-devel/fml/doc/ja/todo/STATUS.html </title> <para> -&fml5; プロジェクトは &fml4; を +&fmldevel; プロジェクトは &fml4; を 1 から書き直す次世代 fml プロジェクトの総称 です。 これは &fml4; までに至る約 10 年の経験を再実装する試みといえます。 ざっくりとしたイメージしては -4.0 と &fml5; の違いは sendmail と postfix のような関係と思って下さい。 +4.0 と &fmldevel; の違いは sendmail と postfix のような関係と思って下さい。 </para> <para> @@ -67,12 +70,16 @@ http://www.fml.org/software/fml-devel/fml/doc/ja/todo/STATUS.html <para> 例えば fml (4.0) を使っていて問題になるのは、 -「特定のホストで、FFS の上にファイルを書く」という -のが基本デザインから継承された構造です。 -では、 -冗長化構成のため NFS にするとどうなる？ -トラブルチケットシステムと連動したい場合は？ -SQL サーバとも連動したいですね？ +「特定のホストで、ディスクの上にメンバーファイルを書く」という +デザインです。 +これは最初のバージョンから継承され続けている基本構造です。 +</para> + +<para> +しかしながら、冗長化構成を考えると +「NFS の時はどうする？」 +「トラブルチケットシステムと連動したい場合は？」 +「SQL サーバとも連動したいですね？」 う〜ん… </para> @@ -80,8 +87,7 @@ SQL サーバとも連動したいですね？ また、構造論ではなく単に自分で欲しい機能があります。 fml 自体がバグトラッキングシステムを提供して欲しいし、 bug tracking system もサーチエンジンもできるだけメールと連動して -いろいろして欲しい。 -それらをよい簡単に書けてほしいです。 +いろいろして欲しい。cvs ログとも連動して欲しい。 </para> <para> @@ -93,14 +99,14 @@ bug tracking system もサーチエンジンもできるだけメールと連動して <listitem> <para> - &fml5; へ引き継ぐべき機能は何か？ + &fmldevel; へ引き継ぐべき機能は何か？ </para> </listitem> <listitem> <para> - &fml5; でもっとうまく、 + &fmldevel; でもっとうまく、 よりカスタマイズしやすいものに実装できないか？ </para> </listitem> @@ -131,24 +137,14 @@ ftp://ftp.fml.org/pub/fml-devel/ </para> <para> -これは、あくまでもアイデアを表現するためのものなので、機能は最低限のも -のしかありませんが、十分動きます。 -作者は fml-devel ＭＬをはじめ、 -いくつかの場所で運用ベースで使っています。 -もっとも、 -変数名もアーキテクチャアも本決まりではないので、 -将来変わる可能性はありますが… -</para> - -<para> -最初の試金石バージョンがリリースされる際には、 +最初の試金石バージョンは <screen> fml 1.2 相当の最低限の機能 + makefml (CUI + CGI) が加わったもの + 自動スレッド追跡システム + 自動 HTML 化機構 </screen> -が動くようになっている見通しです。 +が動きます。 </para> </sect1> @@ -157,12 +153,12 @@ fml 1.2 相当の最低限の機能 <!-- ======================================================== --> <sect1 id="fml.and.fmlng"> <title> - &fml4; と &fml5; の関係 + &fml4; と &fmldevel; の関係 </title> <para> -4.0 と &fml5; は -&fml5; で作られたモジュールのマージと +4.0 と &fmldevel; は +&fmldevel; で作られたモジュールのマージと 4.0 自体のコードの保守をしつつ、 並行開発されていっています。 </para> @@ -173,12 +169,12 @@ fml 1.2 相当の最低限の機能 4.0 の bug fix は 4.0.x (4.0.1 4.0.2 …)としてまとめられリリー スれていく予定です。 4.0-current は 4.0.x のためのテストケースであり、 -&fml5; は本当の開発コード( fml-current )という位置付けといえます。 +&fmldevel; は本当の開発コード( fml-current )という位置付けといえます。 </para> <screen> fml-devel - -----------------------------> 5.0 or 8.0 (本プロジェクトの目標) + -----------------------------> 8.0 ? (次世代プロジェクトの目標) ↑↓交流 1.2 〜 4.0 ------------------------------> 4.0-current | | @@ -187,17 +183,17 @@ fml 1.2 相当の最低限の機能 <para> -&fml5; 用に作られたモジュールを &fml4; へ輸入する予定です。 +&fmldevel; 用に作られたモジュールを &fml4; へ輸入する予定です。 たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)や、 スレッド追跡システムです。 -これは &fml5; の機能を 4.0 でテストをするいう意味あいもあります。 +これは &fmldevel; の機能を 4.0 でテストをするいう意味あいもあります。 この作業は 4.0.4 か 4.0.5 以降本格化する予定です。 </para> <para> 言い替えると、 4.0 系列の bug fix は 4.0 で行ないますが、 -新機能は、&fml5; で開発したものをモジュール単位で 4.0 へ輸入していく +新機能は、&fmldevel; で開発したものをモジュール単位で 4.0 へ輸入していく 形をとります。 </para> @@ -206,101 +202,6 @@ fml 1.2 相当の最低限の機能 <!-- ======================================================== --> -<sect1> - <title> - &fml5; で既に動く機能 - </title> - -<para> - - <itemizedlist> - - - <listitem> - <para> - postfix スタイルの設定ファイル - </para> - </listitem> - - - <listitem> - <para> - 配送、 - ヘッダの書き換え、 - フィルタ( 4.0 の Envelope Filter に相当するもの ) - </para> - </listitem> - - <listitem> - <para> - MTA が起動するメインのプログラム: - fml.pl distribute command - </para> - </listitem> - - - <listitem> - <para> - いくつかのユーティリティ: - fmlconf - fmldoc - fmlhtmlify - fmlsch - fmlthread - makefml - </para> - </listitem> - - - <listitem> - <para> - CGI : - fmlsch.cgi - fmlthread.cgi - makefml.cgi - </para> - </listitem> - - - <listitem> - <para> - IPv6 による配送 - </para> - </listitem> - - - <listitem> - <para> - スレッド追跡システム(CUI と CGI を含む): - (fmlthread fmlthread.cgi) - </para> - </listitem> - - - <listitem> - <para> - 記事の HTML 化システム: - fmlhtmlify および makefml に HTML 化コマンドがあります。 - </para> - </listitem> - - - <listitem> - <para> - <link linkend="module.io.adapter"> - 抽象化 IO 層 - </link> - メンバーファイルをファイル、/etc/group, NIS, MySQL - から取り出すことができます。 - </para> - </listitem> - </itemizedlist> -</para> - -</sect1> - - -<!-- ======================================================== --> <sect1 id="mailinglist"> <title> @@ -308,7 +209,7 @@ fml 1.2 相当の最低限の機能 </title> <para> -fml 5 の議論のためのメーリングリストを用意してあります。 +次世代 fml の議論のためのメーリングリストを用意してあります。 </para> <para> @@ -360,7 +261,7 @@ fml-devel ＭＬのログは </title> <para> -&fml5; のアイデアのついて、 +&fmldevel; のアイデアのついて、 <ulink url="mailto:fml-request@fml.org"> ご意見・御感想をお待ち </ulink> diff --git a/fml/doc/ja/tutorial/threadtrack/chapter.sgml b/fml/doc/ja/tutorial/threadtrack/chapter.sgml index bd44e66e..1b3d19b4 100644 --- a/fml/doc/ja/tutorial/threadtrack/chapter.sgml +++ b/fml/doc/ja/tutorial/threadtrack/chapter.sgml @@ -1,5 +1,5 @@ <!-- - $FML: chapter.sgml,v 1.2 2001/11/23 15:00:48 fukachan Exp $ + $FML: chapter.sgml,v 1.3 2002/04/01 23:41:06 fukachan Exp $ --> @@ -9,7 +9,7 @@ </title> <para> -fml 5.0 の問題意識は +&fmldevel; の問題意識は 「ＭＬを走らせたら、スレッドのまとめくらい宜しくやって欲しい」 ということです。 あえていえば、インチキ knowledge database のようなものです。 @@ -106,11 +106,11 @@ closed この問題について解決されたと判断された時 -<!-- fml 5.0 モデル --> +<!-- &fmldevel; モデル --> <sect1> <title> - fml 5.0 (minimal_states モデル版)チケットシステム + &fmldevel; (minimal_states モデル版)チケットシステム </title> diff --git a/fml/doc/ja/tutorial/usage/cgi.sgml b/fml/doc/ja/tutorial/usage/cgi.sgml index 235701be..bc1fb346 100644 --- a/fml/doc/ja/tutorial/usage/cgi.sgml +++ b/fml/doc/ja/tutorial/usage/cgi.sgml @@ -1,5 +1,5 @@ <!-- - $FML: cgi.sgml,v 1.2 2002/03/18 13:34:36 fukachan Exp $ + $FML: cgi.sgml,v 1.3 2002/04/01 23:41:07 fukachan Exp $ --> <chapter id="cgi"> @@ -10,6 +10,26 @@ <para> CGI による設定ツールです。 CGI で可能な項目は makefml のサブセットとなります。 +<screen> +例: CGI トップ画面 + + @home.fml.org CGI for configuration + +fml admin menu fml CGI interface for @home.fml.org ML's +mailing list: +[elena] 左のナビゲーションバーから、ＭＬ(mailing list)とコマ +command: ンド(command)を選択し、 submit ボタンを押して下さい +[subscribe ] 。 +[submit][reset] + subscribe アドレスの追加 + unsubscribe アドレスの削除 + addadmin リモート管理者アドレスの追加 + byeadmin リモート管理者アドレスの削除 +options Language: list アドレスリストを見る +[Japanese] [change] log ログを見る + newml ＭＬの作成 + rmml ＭＬの削除 +</screen> </para> <para> @@ -21,5 +41,4 @@ CGI で可能な項目は makefml のサブセットとなります。 </para> - </chapter> diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml index dc52c359..01abfc37 100644 --- a/fml/doc/ja/tutorial/usage/command.sgml +++ b/fml/doc/ja/tutorial/usage/command.sgml @@ -1,5 +1,5 @@ <!-- - $FML: chapter.sgml,v 1.3 2001/10/13 08:47:54 fukachan Exp $ + $FML: command.sgml,v 1.1 2001/11/24 03:22:58 fukachan Exp $ --> <chapter id="fml.command.bymail"> @@ -15,7 +15,7 @@ fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして <para> -fml 5.0 では +&fmldevel; では <screen> メールによるコマンド処理 makefml によるコマンド処理 diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml index 9ed021b9..64829145 100644 --- a/fml/doc/ja/tutorial/usage/makefml.sgml +++ b/fml/doc/ja/tutorial/usage/makefml.sgml @@ -1,5 +1,5 @@ <!-- - $FML: makefml.sgml,v 1.1 2001/11/24 03:22:59 fukachan Exp $ + $FML: makefml.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $ --> <sect1 id="usage.makefml"> @@ -7,7 +7,7 @@ <title> makefml を使って、ユーザの登録/削除他(あらゆる:) </title> <para> -makefml の基本的な使い方は fml 4.0 の makefml と同様です。 +makefml の基本的な使い方は &fml4; の makefml と同様です。 というより、できるだけ互換性を保つように構築する予定です。 </para> @@ -55,6 +55,15 @@ makefml の基本的な使い方は fml 4.0 の makefml と同様です。 <listitem> <para> + ＭＬの削除 + ( + rmml + ) + </para> + </listitem> + + <listitem> + <para> ファイルを送り返す ( get diff --git a/fml/doc/ja/tutorial/usage/newml.sgml b/fml/doc/ja/tutorial/usage/newml.sgml index 69bad730..d6ac1c09 100644 --- a/fml/doc/ja/tutorial/usage/newml.sgml +++ b/fml/doc/ja/tutorial/usage/newml.sgml @@ -1,5 +1,5 @@ <!-- - $FML: newml.sgml,v 1.1 2002/03/18 07:39:58 fukachan Exp $ + $FML: newml.sgml,v 1.2 2002/04/01 23:41:07 fukachan Exp $ --> <!-- @@ -16,7 +16,7 @@ <chapter id="usage.newml"> <title> - ＭＬを作成する (UNIX 編) + UNIX 上でＭＬを作成する </title> @@ -165,23 +165,70 @@ aliases の設定の仕方は一緒です。 <sect1> <title> - aliaess のカスタマイズ + aliaess の更新 </title> <para> makefml はシステムの aliases を変更することはありませんが、 $ml_home_prefix/etc/mail/aliases -への追加が自動的に行なわれているはずです。 -システムへの追加が必要なら、次のようにして下さい。 +への追加と aliases.db の更新が自動的に行なわれているはずです。 +</para> + + +<sect2> + <title> + postfix の設定 + </title> + +<para> +makefml newml を実行するだけでＭＬが自動的に有効になるように、あらかじ +め postfix の設定を変更しておいて下さい。 +具体的には postfix の /etc/postfix/main.cf を次のようにしておきます。 <screen> -elena: :include:/var/spool/ml/elena/include -elena-ctl: :include:/var/spool/ml/elena/include-ctl -elena-admin: fml -owner-elena: fml -owner-elena-ctl: fml +alias_maps = hash:/etc/mail/aliases + hash:/var/spool/ml/etc/mail/aliases </screen> </para> +</sect2> + + +<sect2> + <title> + qmail の設定 + </title> + +<para> +makefml newml は次のような qmail 用の設定ファイルを作ります。 +<screen> +~/.qmail-fml:org-elena +~/.qmail-fml:org-elena-ctl +</screen> +よって +<screen> +/var/qmail/control/virtualdomains +</screen> +に、あらかじめ次のような設定を仕込んでおけば、 +makefml newml を実行するだけで +qmail でも自動的にＭＬが有効になります。 +<screen> +fml.org:fml-fml.org +</screen> +</para> + +<warning> +<para> +この設定は、ＭＬ用に一つのドメインをまるまる使うことを前提としています。 +</para> +</warning> + +</sect2> + + +<sect2> + <title> + 例: /var/spool/ml/etc/mail/aliases + </title> <para> aliases のエントリは @@ -209,6 +256,8 @@ $ml_home_prefix の部分は $virtual_maps にしたがって自動的に変化します。 </para> +</sect2> + </sect1> diff --git a/fml/doc/ja/tutorial/usage/procmail.sgml b/fml/doc/ja/tutorial/usage/procmail.sgml index e59ec42d..db7617c4 100644 --- a/fml/doc/ja/tutorial/usage/procmail.sgml +++ b/fml/doc/ja/tutorial/usage/procmail.sgml @@ -1,5 +1,5 @@ <!-- - $FML: procmail.sgml,v 1.1 2001/11/25 03:52:13 fukachan Exp $ + $FML: procmail.sgml,v 1.2 2002/04/01 23:41:08 fukachan Exp $ --> <chapter id="fml.bymyaccount"> @@ -20,7 +20,7 @@ <para> こういった場合、 -fml 5.0 ではユーザが +&fmldevel; ではユーザが procmail などの振分ツールを使うだろうと期待しています :-) </para> |