diff options
| author | fukachan <fukachan> | 2004-10-06 09:07:32 +0000 |
|---|---|---|
| committer | fukachan <fukachan> | 2004-10-06 09:07:32 +0000 |
| commit | c28f77a719294cd65401617304bc0a9d14544e97 (patch) | |
| tree | 42f66c78ea470857f342fe21afa8d4650dce7617 /fml | |
| parent | 3bc4bf9bd8f8c7ac269dc596a6813c1afc86578f (diff) | |
| download | fml8-c28f77a719294cd65401617304bc0a9d14544e97.tar.gz fml8-c28f77a719294cd65401617304bc0a9d14544e97.tar.bz2 fml8-c28f77a719294cd65401617304bc0a9d14544e97.zip | |
overhaul:
o clean up
o minor bug fixes
Diffstat (limited to 'fml')
92 files changed, 682 insertions, 382 deletions
diff --git a/fml/doc/ja/tutorial/changes/chapter.sgml b/fml/doc/ja/tutorial/changes/chapter.sgml index c67a9dc6..8eec40d7 100644 --- a/fml/doc/ja/tutorial/changes/chapter.sgml +++ b/fml/doc/ja/tutorial/changes/chapter.sgml @@ -1,5 +1,5 @@ <!-- - $FML: chapter.sgml,v 1.1.1.1 2004/04/02 04:39:48 fukachan Exp $ + $FML: chapter.sgml,v 1.2 2004/04/07 11:06:59 fukachan Exp $ --> @@ -20,8 +20,8 @@ </title> <para> -大雑把に言えば、GPL か BSD 準拠、もしくは Artistic のどれかになってい -るはずです。 +大雑把に言えば、ソースコードは GPL か BSD 準拠、もしくは Artistic のい +づれかになっているはずです。 </para> <para> @@ -52,7 +52,7 @@ gnu はその名の通りです。img は BSD ライセンス準拠です。詳しくは、それ </title> <para> -返事の際には、Accept-Languageなどを参考に言語の自動選択が行なわれます。 +返事の際には、Accept-Language などを参考に言語の自動選択が行なわれます。 詳しくは <link linkend="language.preference"> <xref linkend="language.preference"> @@ -62,7 +62,10 @@ gnu はその名の通りです。img は BSD ライセンス準拠です。詳しくは、それ <para> ファイルを送り返す際、基本は MIME/Multipart です。 -現在、tar.gz や zip 形式などは未サポートです。 +</para> + +<para> +また、現在、tar.gz や zip 形式などは未サポートです。 </para> </sect1> @@ -141,7 +144,7 @@ makefml から実行される各コマンドの相違点は以下の通りです。 <para> &fml8; では、newml 実行時に、GUI のスクリプトは用意されます。 -しかしながら、apache の設定などは実行しなければなりません。 +しかしながら、apache の設定変更などは別途必要です。 </para> <para> @@ -150,6 +153,11 @@ makefml から実行される各コマンドの相違点は以下の通りです。 一方、&fml8; ではテーブルベースのものになっています。 </para> +<para> +将来の課題としては、GUI のスキンを選べるようにするなども考えなくてはい +けないでしょう。 +</para> + </sect1> @@ -167,13 +175,13 @@ makefml から実行される各コマンドの相違点は以下の通りです。 いずれにせよ、 &fml4; から &fml8; に変換するツールが頑張って、よろしくファイル名の変 更などはしてくれるはずなので、手作業で変換することはないとおもいます。 -が、読む時に困るので、ここで差分を書いておきます。 +しかしながら、読む時に困るでしょうから、ここで差分を書いておきます。 </para> <para> 受信者とメンバーリストを別々に管理するという方針は変わりませんが、 ファイル名は異なります。 -actives は recipients となりました。 +actives は recipients となり、ファイルの意味が明瞭になりました。 一方、members はそのままです。 </para> diff --git a/fml/doc/ja/tutorial/command/chapter.sgml b/fml/doc/ja/tutorial/command/chapter.sgml index afd8e2e4..65b742f6 100644 --- a/fml/doc/ja/tutorial/command/chapter.sgml +++ b/fml/doc/ja/tutorial/command/chapter.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.sgml,v 1.7 2002/12/25 11:50:42 fukachan Exp $ + $FML: chapter.sgml,v 1.8 2004/04/07 11:06:59 fukachan Exp $ --> + <chapter id="fml.command.modules"> <title> コマンド(コマンドメール、makefml、CGI) diff --git a/fml/doc/ja/tutorial/command/dataflow.sgml b/fml/doc/ja/tutorial/command/dataflow.sgml index da5ceaa6..2188e4e8 100644 --- a/fml/doc/ja/tutorial/command/dataflow.sgml +++ b/fml/doc/ja/tutorial/command/dataflow.sgml @@ -1,5 +1,5 @@ <!-- - $FML: dataflow.sgml,v 1.2 2004/03/12 14:04:09 fukachan Exp $ + $FML: dataflow.sgml,v 1.3 2004/04/07 11:07:00 fukachan Exp $ --> @@ -14,9 +14,9 @@ --> <para> -すべての処理は最終的に FML::Command 経由で FML::Command::モード::コマ -ンド クラスを呼び出します。GUI および CUI、コマンドメールは、そこに至 -る前処理が異なるだけです。 +すべての処理は最終的に「FML::Command」クラス経由で「FML::Command::モー +ド::コマンド」クラスを呼び出します。GUI および CUI、コマンドメールは、 +そこに至る前処理の段階が異なるだけです。 </para> @@ -32,7 +32,7 @@ </caution> <para> -コマンドは行単位で、解析されます。 +まず、コマンドは行単位で、解析されます。 </para> <para> @@ -55,16 +55,16 @@ 「呼び出しルーチン」では、 (コマンドに依存した)返事の送り先の確認と (コマンドに依存する)シンタックスチェックを経て、 -FML::Command 経由でコマンドが実行されます。 +FML::Command クラス経由でコマンドが実行されます。 この実行は一般ユーザ権限で実行されます。 </para> <para> -admin コマンドの実行は、ここでは行なわれません。 -「admin ...」コマンドは、まず一般ユーザ権限で実行され、 -FML::Command::User::admin クラスが呼び出されます。 -この中で、$admin_command_mail_restrictions に基づいて、リモート権限があるか？ -が確認され、もう一度 FML::Command 経由で管理者権限の +admin コマンドの実行は、ここでは行なわれません。「admin ...」コマンド +は、まず一般ユーザ権限の admin コマンドとして処理が薦められ、最終的に +「FML::Command::User::admin」クラスが呼び出されます。このクラスの中で、 +$admin_command_mail_restrictions に基づいてリモート権限があるか？が確 +認され、もう一度「FML::Command」クラス経由で管理者権限の 「FML::Command::Admin::コマンド」クラスが呼び出されます。 </para> diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml index 5631a374..1acccf54 100644 --- a/fml/doc/ja/tutorial/command/extension.sgml +++ b/fml/doc/ja/tutorial/command/extension.sgml @@ -1,5 +1,5 @@ <!-- - $FML: extension.sgml,v 1.10 2003/04/15 14:51:36 fukachan Exp $ + $FML: extension.sgml,v 1.11 2004/04/07 11:07:00 fukachan Exp $ --> @@ -18,7 +18,7 @@ <warning> <para> -このホスト上の全ての ML で利用可能なコマンドを作りたい場合は、 +このホスト上の「全ての ML で利用可能な」コマンドを作りたい場合は、 拡張したモジュールを <screen> /usr/local/lib/fml/site_local/ @@ -31,10 +31,13 @@ 以下において下さい。 </para> +<!-- <para> 以下では、このホスト全ての ML で有効にする場合を考えます。 -もちろん、どっちにケースでもモジュールの書き方は一緒です。 +もちろん、どちらのケースでもモジュールの書き方は一緒です。 </para> +--> + </warning> @@ -49,11 +52,21 @@ FML::Command 以下から適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/User/uja.pm </screen> -というファイルを置き、site_default_config.cf に許可するコマンドリスト -に追加してください。 +というファイルを置き、設定ファイルで +uja を許可するコマンドリストに追加して下さい。 + +全ての ML で有効にする場合は、site_default_config.cf で、 +許可するコマンドリストに追加してください。 +<screen> +user_command_mail_allowed_commands += uja +</screen> + +elena ML だけで有効にする場合は、elena ML の config.cf で、 +許可するコマンドリストに追加してください。 <screen> user_command_mail_allowed_commands += uja </screen> + </para> </sect2> @@ -70,8 +83,19 @@ FML::Command 以下から適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/Admin/uja.pm </screen> -というファイルを置き、site_default_config.cf に許可するコマンドリスト -に追加してください。 +というファイルを置いてください。 + + +全ての ML で有効にする場合は、site_default_config.cf で、 +許可するコマンドリストに追加してください。 +<screen> +admin_command_mail_allowed_commands += uja +</screen> +</para> + +<para> +elena ML だけで有効にする場合は、elena ML の config.cf で、 +許可するコマンドリストに追加してください。 <screen> admin_command_mail_allowed_commands += uja </screen> @@ -158,8 +182,18 @@ FML::Command 以下から適当に cut and paste して <screen> /usr/local/lib/fml/site_local/FML/Command/Admin/uja.pm </screen> -というファイルを置き、site_default_config.cf に許可するコマンドリスト -に追加してください。 +というファイルを置いてください。 + +全ての ML で有効にする場合は、site_default_config.cf で、 +許可するコマンドリストに追加してください。 +<screen> +admin_cgi_allowed_commands += uja +</screen> +</para> + +<para> +elena ML だけで有効にする場合は、elena ML の config.cf で、 +許可するコマンドリストに追加してください。 <screen> admin_cgi_allowed_commands += uja </screen> diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml index 517f75a8..ebbcf26a 100644 --- a/fml/doc/ja/tutorial/command/internal.sgml +++ b/fml/doc/ja/tutorial/command/internal.sgml @@ -1,16 +1,18 @@ <!-- - $FML: internal.sgml,v 1.8 2004/04/07 11:07:00 fukachan Exp $ + $FML: internal.sgml,v 1.9 2004/04/21 08:48:47 fukachan Exp $ --> + <sect1 id="fml.command.internal.change"> <title> 補足: - 『&fml4;と &fmldevel; のコードの書き方はどのくらい違うか？』 + 『&fml4;と &fml8; のコードの書き方はどのくらい違うか？』 </title> <para> -コマンドの典型である『ファイルを送り返す』だけの help コマンドを例にと -り、相違点を説明しましょう。 +コマンドの典型である『ファイルを送り返す』だけの +help コマンドを例にとり、 +相違点を説明しましょう。 </para> <para> @@ -33,7 +35,7 @@ sub myProcHelpFileSendBack </para> <para> -&fmldevel; では help ファイルを送り返すコードの実体は +&fml8; では help ファイルを送り返すコードの実体は FML::Command::User::help にあり、 FML::Process::Command クラスから (FML::Command の AUTOLOAD を経由して)呼び出されます。 @@ -85,8 +87,8 @@ sub process </para> <para> -変数は、&fml4; ではグローバル変数群です。一方 &fml8; では $config オブ -ジェクトを通じてアクセスできる設定変数空間の中にあります。 +変数ですが、&fml4; ではグローバル変数群です。一方 &fml8; では $config +オブジェクトを通じてアクセスできる設定変数空間の中にあります。 </para> <para> diff --git a/fml/doc/ja/tutorial/customize/autoreply.sgml b/fml/doc/ja/tutorial/customize/autoreply.sgml index 5e81e111..06f97866 100644 --- a/fml/doc/ja/tutorial/customize/autoreply.sgml +++ b/fml/doc/ja/tutorial/customize/autoreply.sgml @@ -1,7 +1,8 @@ <!-- - $FML: autoreply.sgml,v 1.2 2003/01/05 08:00:59 fukachan Exp $ + $FML: autoreply.sgml,v 1.3 2004/04/07 11:07:01 fukachan Exp $ --> + <sect1 id="config.autoreply"> <title> ケーススタディ: 自動ファイル送り返しサーバ diff --git a/fml/doc/ja/tutorial/customize/case_studies.sgml b/fml/doc/ja/tutorial/customize/case_studies.sgml index 16fdac37..5fecba0b 100644 --- a/fml/doc/ja/tutorial/customize/case_studies.sgml +++ b/fml/doc/ja/tutorial/customize/case_studies.sgml @@ -1,5 +1,5 @@ <!-- - $FML: case_studies.sgml,v 1.5 2003/11/29 07:29:12 fukachan Exp $ + $FML: case_studies.sgml,v 1.6 2004/04/07 11:07:01 fukachan Exp $ --> @@ -17,8 +17,8 @@ ヘッダ関連では、まず Subject: にタグをつけないことにしました。 <footnote> <para> -なお、この設定はデフォルトの site_default_config.cf に仕込まれているた -め、&fmldevel; のデフォルトです。 +なお、この設定はデフォルトの site_default_config.cf に仕込まれています。 +つまり &fml8; のデフォルトです。 </para> </footnote> ことにした。 @@ -38,6 +38,7 @@ outgoing_mail_header_x_ml_name = office#$ml_name <para> 記事は誰でも投稿可能としましょう。 +ここでは root さんからのシステムメールなども許しています。 <screen> article_post_restrictions = permit_anyone </screen> diff --git a/fml/doc/ja/tutorial/customize/chapter.command.sgml b/fml/doc/ja/tutorial/customize/chapter.command.sgml index 071dbe56..ea0d974a 100644 --- a/fml/doc/ja/tutorial/customize/chapter.command.sgml +++ b/fml/doc/ja/tutorial/customize/chapter.command.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.command.sgml,v 1.1 2002/09/15 01:46:30 fukachan Exp $ + $FML: chapter.command.sgml,v 1.2 2004/04/07 11:07:02 fukachan Exp $ --> + <chapter id="customize.command"> <title> コマンドの拡張 diff --git a/fml/doc/ja/tutorial/customize/chapter.config.sgml b/fml/doc/ja/tutorial/customize/chapter.config.sgml index 7a671d7d..ee5163b4 100644 --- a/fml/doc/ja/tutorial/customize/chapter.config.sgml +++ b/fml/doc/ja/tutorial/customize/chapter.config.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.config.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $ + $FML: chapter.config.sgml,v 1.4 2004/04/07 11:07:02 fukachan Exp $ --> + <chapter id="config"> <title> 設定ファイルを変更する @@ -14,7 +15,7 @@ </title> <para> -/usr/local/etc/fml/site_default_config.cf に書いて下さい。 +設定を /usr/local/etc/fml/site_default_config.cf に書いて下さい。 フォーマットは .cf 形式、つまり config.cf と同様です。 </para> diff --git a/fml/doc/ja/tutorial/customize/chapter.header.sgml b/fml/doc/ja/tutorial/customize/chapter.header.sgml index 8f232d1e..0881a3d5 100644 --- a/fml/doc/ja/tutorial/customize/chapter.header.sgml +++ b/fml/doc/ja/tutorial/customize/chapter.header.sgml @@ -1,12 +1,14 @@ <!-- - $FML: chapter.header.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $ + $FML: chapter.header.sgml,v 1.4 2004/04/07 11:07:02 fukachan Exp $ --> + <chapter id="customize.header"> <title> ヘッダの書き換え </title> + <para> ヘッダ情報は FML::Header クラスのオブジェクトに収納されています。 なお FML::Header は Mail::Header を継承しているので、 diff --git a/fml/doc/ja/tutorial/customize/chapter.message.sgml b/fml/doc/ja/tutorial/customize/chapter.message.sgml index 3a52f09c..9e188ee1 100644 --- a/fml/doc/ja/tutorial/customize/chapter.message.sgml +++ b/fml/doc/ja/tutorial/customize/chapter.message.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.message.sgml,v 1.1 2002/09/15 01:46:30 fukachan Exp $ + $FML: chapter.message.sgml,v 1.2 2003/04/15 14:51:36 fukachan Exp $ --> + <chapter id="customize.message"> <title> メッセージの拡張 diff --git a/fml/doc/ja/tutorial/customize/chapter.ml_style.sgml b/fml/doc/ja/tutorial/customize/chapter.ml_style.sgml index ecf635de..55193d23 100644 --- a/fml/doc/ja/tutorial/customize/chapter.ml_style.sgml +++ b/fml/doc/ja/tutorial/customize/chapter.ml_style.sgml @@ -1,6 +1,8 @@ <!-- - $FML: chapter.ml_style.sgml,v 1.3 2002/07/29 12:16:18 fukachan Exp $ + $FML: chapter.ml_style.sgml,v 1.4 2003/02/16 13:07:15 fukachan Exp $ --> + + <chapter id="cuctomize"> <title> カスタマイズの事例 diff --git a/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml b/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml index 8e7e06eb..682dabe2 100644 --- a/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml +++ b/fml/doc/ja/tutorial/customize/command_permit_anyone.sgml @@ -1,7 +1,8 @@ <!-- - $FML: command_permit_anyone.sgml,v 1.2 2003/01/05 08:00:59 fukachan Exp $ + $FML: command_permit_anyone.sgml,v 1.3 2004/04/07 11:07:02 fukachan Exp $ --> + <sect1 id="config.command.permitanyone"> <title> ケーススタディ: 誰でもコマンドメールが使える diff --git a/fml/doc/ja/tutorial/customize/command_rejectall.sgml b/fml/doc/ja/tutorial/customize/command_rejectall.sgml index 7ed54944..7975c881 100644 --- a/fml/doc/ja/tutorial/customize/command_rejectall.sgml +++ b/fml/doc/ja/tutorial/customize/command_rejectall.sgml @@ -1,15 +1,21 @@ <!-- - $FML: command_rejectall.sgml,v 1.3 2003/04/15 14:51:36 fukachan Exp $ + $FML: command_rejectall.sgml,v 1.4 2004/04/07 11:07:02 fukachan Exp $ --> + <sect1 id="config.command.rejectall"> <title> - ケーススタディ: コマンドを誰も使えないようにする + ケーススタディ: コマンドメールを誰も使えないようにする </title> <para> -コマンドプロセスが起動しても、即効で終了するようにすることができます。 -これが(aliases を編集することをのぞけば)一番確実な方法です。 +とうぜん、aliases を編集して、該当する行を削除するのが一番確実です。 +それ以外の方法としては、次のようなものが考えられます。 +</para> + +<para> +コマンドメールのプロセスが起動しても、即効で終了するようにすることがで +きます。これが(aliases を編集することをのぞけば)一番確実な方法です。 <screen> use_command_mail_function = no </screen> diff --git a/fml/doc/ja/tutorial/customize/filter.sgml b/fml/doc/ja/tutorial/customize/filter.sgml index 620fea88..99a3d77e 100644 --- a/fml/doc/ja/tutorial/customize/filter.sgml +++ b/fml/doc/ja/tutorial/customize/filter.sgml @@ -1,7 +1,8 @@ <!-- - $FML: filter.sgml,v 1.2 2003/04/13 04:36:11 fukachan Exp $ + $FML: filter.sgml,v 1.3 2004/05/19 13:17:59 fukachan Exp $ --> + <chapter> <title> フィルタ diff --git a/fml/doc/ja/tutorial/customize/mailmagazine.sgml b/fml/doc/ja/tutorial/customize/mailmagazine.sgml index 9f730204..7f231bfd 100644 --- a/fml/doc/ja/tutorial/customize/mailmagazine.sgml +++ b/fml/doc/ja/tutorial/customize/mailmagazine.sgml @@ -1,5 +1,5 @@ <!-- - $FML: mailmagazine.sgml,v 1.4 2004/04/07 11:07:02 fukachan Exp $ + $FML: mailmagazine.sgml,v 1.5 2004/06/23 15:07:16 fukachan Exp $ --> @@ -9,6 +9,19 @@ </title> +<warning> +<para> +ここではメールヘッダによる認証しか取り上げていませんが、 +安全のため、もっともっと厳しい設定をするべきです。 +</para> + +<para> +たとえば、そもそもインターネット側に SMTP インターフェイスがないような +サーバの設定、およびサーバの設置場所の選定などを行なうべきです。 +</para> +</warning> + + <para> メールマガジンは投稿可能なメンバーリストをカスタマイズすることで行なえ ます。 @@ -93,6 +106,8 @@ smtp_servers = 127.0.0.1:2025 % fml -o smtp_servers=127.0.0.1:25 ＭＬ名 flushq </screen> +ちなみに flush と flushq コマンドは同じ意味です。 +flushq が打ちづらいので flush コマンドも作ってみました。 </para> </sect1> diff --git a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml index 9992e3e4..0d33ce44 100644 --- a/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml +++ b/fml/doc/ja/tutorial/customize/post_permit_anyone.sgml @@ -1,18 +1,19 @@ <!-- - $FML: post_permit_anyone.sgml,v 1.4 2003/11/30 10:01:13 fukachan Exp $ + $FML: post_permit_anyone.sgml,v 1.5 2004/04/07 11:07:02 fukachan Exp $ --> + <sect1 id="config.post.permitanyone"> <title> ケーススタディ: 誰でも投稿可能なＭＬ </title> <para> +article_post_restrictions は記事の投稿を許すメンバーを定義しています。 +これを permit_anyone とすると、だれでも投稿可能になります。 <screen> article_post_restrictions = permit_anyone </screen> -article_post_restrictions は記事の投稿を許すメンバーを定義しています。 -これを permit_anyone とすると、だれでも投稿可能になります。 </para> <para> diff --git a/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml b/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml index 10ccee02..ca521a06 100644 --- a/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml +++ b/fml/doc/ja/tutorial/customize/recipe.filter.notice.sgml @@ -1,5 +1,5 @@ <!-- - $FML: recipe.filter.notice.sgml,v 1.2 2003/04/15 14:51:37 fukachan Exp $ + $FML: recipe.filter.notice.sgml,v 1.3 2004/04/07 11:07:02 fukachan Exp $ --> @@ -20,7 +20,7 @@ use_article_filter_reject_notice = yes article_filter_reject_notice_recipient = maintainer sender </screen> となっています。 -つまり、エラーメールを返し、返す先はＭＬの管理者です。 +つまり、エラーメールを返し、返す先はＭＬの管理者と送信者の両方です。 </para> diff --git a/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml b/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml index 39f64181..7242c250 100644 --- a/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml +++ b/fml/doc/ja/tutorial/customize/recipe.filter.spamassassin.sgml @@ -1,5 +1,5 @@ <!-- - $FML: recipe.filter.spamassassin.sgml,v 1.1 2004/05/19 13:18:00 fukachan Exp $ + $FML: recipe.filter.spamassassin.sgml,v 1.2 2004/05/20 12:34:26 fukachan Exp $ --> @@ -7,7 +7,7 @@ <question> <para> -spamassassin で SPAM メールを無視する。 +spamassassin で SPAM メールを無視する (HOOK を使った例)。 </para> </question> @@ -74,8 +74,7 @@ $distribute_verify_request_end_hook = q{ </para> <para> -ちょっとトリッキーだが、動作はする。 -そのうち、もうちょっと変えるつもりでつ。 +ちょっとトリッキーですが、動きます。 </para> </answer> diff --git a/fml/doc/ja/tutorial/delivery/chapter.sgml b/fml/doc/ja/tutorial/delivery/chapter.sgml index ad8d7a8b..d0a01394 100644 --- a/fml/doc/ja/tutorial/delivery/chapter.sgml +++ b/fml/doc/ja/tutorial/delivery/chapter.sgml @@ -1,19 +1,21 @@ <!-- - $FML: chapter.sgml,v 1.11 2002/10/29 03:44:17 fukachan Exp $ + $FML: chapter.sgml,v 1.12 2003/04/15 14:51:37 fukachan Exp $ --> + <chapter id="delivery"> <TITLE> - &fmldevel; のメール配送システム + &fml8; のメール配送システム </TITLE> -<sect1 id="fmldevel-delivery"> + +<sect1 id="fml8-delivery"> <title> - &fml4; と &fmldevel; の相違点 + &fml4; と &fml8; の相違点 </title> <para> -&fmldevel; の最大の目的の一つは、メンバーリストの取得操作におけるコー +&fml8; の最大の目的の一つは、メンバーリストの取得操作におけるコー ドの統合と抽象化です。配送には抽象化された Mail::Delivery クラスを次の ように使います。 </para> @@ -89,6 +91,23 @@ Mail::Message §.mailqueue; +<sect1 id="delivery.qmgr"> + <title> + キュー管理システム + </title> + +<!-- + XXX-TODO: もっと、キュー管理システムについて詳しく書いて！ +--> + +<para> +2004 夏以降、&fml8; の配送システムはキュー管理システムのもとで動いてい +ます。これにより再送処理が可能となりました。 +</para> + +</sect1> + + <sect1> <title> 議論: FML::Mailer は必要か？ diff --git a/fml/doc/ja/tutorial/delivery/queue.sgml b/fml/doc/ja/tutorial/delivery/queue.sgml index 3e528a2f..fa39ef9e 100644 --- a/fml/doc/ja/tutorial/delivery/queue.sgml +++ b/fml/doc/ja/tutorial/delivery/queue.sgml @@ -1,7 +1,8 @@ <!-- - $FML: queue.sgml,v 1.5 2004/05/21 11:54:06 fukachan Exp $ + $FML: queue.sgml,v 1.6 2004/05/28 04:20:48 fukachan Exp $ --> + <sect1 id="message.queue.incoming"> <TITLE> fml がメールを読みこむ際のキューイング @@ -13,10 +14,10 @@ fmlの各プロセスは MTA から起動され、STDIN(標準入力)からメールを読みこ </para> <para> -fml は、いったんメールを読みこみ、まずはディスクに書き込みます。書き込 -みに成功した場合、その書き込んだファイルに対してメッセージの解析をスター -トします。これにより、少なくとも読みこんだオリジナルのメールの記録は残 -せます。 +fml は、いったんメールを読みこみ、まずはディスクに書き込みます +(incoming queue へ書き込む)。書き込みに成功した場合、その書き込んだファ +イルに対してメッセージの解析をスタートします。これにより、少なくとも読 +みこんだオリジナルのメールの記録は残せます。 </para> <para> @@ -26,9 +27,9 @@ exit(75) です。このエラーコードをうけとると、MTA は一時的なエラーがお </para> <para> -このキューの処理はMail::Delivery::Queueを使い、ＭＬ固有の queue で管理 -されます。一連の処理が終ると、たいていは、そのプロセスの最後に、このキュー -は消されます。 +incoming queue の処理は Mail::Delivery::Queue を使い、ＭＬ固有の queue +で管理されます。一連の処理が終ると、たいてい、そのプロセスの最後に、 +このキューは消されます。 </para> </sect1> @@ -122,8 +123,9 @@ Mail::Delivery <para> キューを操作する際には、対象のキューを flock(2) します。ロックを他の -ATOMIC操作を使って実装してもよいのですが、flock(2) を使う最大の理由は、 -操作途中にOSが逝ってしまうケースを想定しているためです。 +ATOMIC 操作を使って実装してもよいのですが、 +操作途中に OS が逝ってしまうケースを想定すると、 +やはり flock(2) を使うべきでしょう。 </para> </sect1> @@ -146,6 +148,8 @@ info/recipients/ info/transport/ </screen> info/ には envelope 情報が格納されます。 +また incoming/ は incoming queue ですが、それ以外のディレクトリは +outgoing 用です。 </para> <para> diff --git a/fml/doc/ja/tutorial/delivery/recipe.forward.sgml b/fml/doc/ja/tutorial/delivery/recipe.forward.sgml index 108768fc..bb8a35a2 100644 --- a/fml/doc/ja/tutorial/delivery/recipe.forward.sgml +++ b/fml/doc/ja/tutorial/delivery/recipe.forward.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: recipe.forward.sgml,v 1.2 2003/04/15 14:51:38 fukachan Exp $ --> + <qandaentry> <question> <para> diff --git a/fml/doc/ja/tutorial/devel/create_program.sgml b/fml/doc/ja/tutorial/devel/create_program.sgml index 242b1511..fd76b420 100644 --- a/fml/doc/ja/tutorial/devel/create_program.sgml +++ b/fml/doc/ja/tutorial/devel/create_program.sgml @@ -1,7 +1,8 @@ <!-- - $FML: create_program.sgml,v 1.7 2003/12/23 06:20:36 fukachan Exp $ + $FML: create_program.sgml,v 1.8 2004/04/07 11:07:04 fukachan Exp $ --> + <chapter id="program.create"> <title> 新プログラムの作成 @@ -123,9 +124,9 @@ lrwxr-xr-x 1 root wheel 6 Apr 14 18:25 mead@ -> loader </para> <para> -CGI のプログラムは +CGI のプログラム本体は FML::CGI::○○○ -というモジュールです。 +というクラスのモジュールです。 CGI 系列では次のような、オブジェクトの関係があります。 <screen> FML::Process::Kernel @@ -180,7 +181,7 @@ verify_request() および run() から呼ばれた先のメソッドとなっています。 CGI プロセスは FML::Process::CGI で駆動され、run() メソッドは <screen> $curproc->html_start($args); -画面を作るために run_cgi_xxx() メソッド郡を呼び出す。 +画面を作るために run_cgi_xxx() メソッド群を呼び出す。 $curproc->html_end($args); </screen> の順に FML::CGI:: 以下のメソッド群を呼び出しています。 diff --git a/fml/doc/ja/tutorial/devel/cvstree.sgml b/fml/doc/ja/tutorial/devel/cvstree.sgml index bb8f8122..0ed54885 100644 --- a/fml/doc/ja/tutorial/devel/cvstree.sgml +++ b/fml/doc/ja/tutorial/devel/cvstree.sgml @@ -1,10 +1,11 @@ <!-- - $FML: cvstree.sgml,v 1.8 2002/07/06 14:55:16 fukachan Exp $ + $FML: cvstree.sgml,v 1.9 2003/04/15 14:51:38 fukachan Exp $ --> + <appendix id="cvs.dirhier"> <title> - cvs repository の構造 + cvs リポジトリの構造 </title> @@ -15,7 +16,7 @@ </title> <para> -&fmldevel; の基本方針として、使えるもの(例えば CPAN )は片っ端から使い +&fml8; の基本方針として、使えるもの(例えば CPAN )は片っ端から使い ます。そうしないと、自分で保守するべき項目が増えるだけだからです。 </para> @@ -28,10 +29,10 @@ <para> CPAN/ や 3rdparty/ 以下のモジュールを変更したい場合は fml/ 以下で、な -んらかのラップをするか、パッチをオリジナルに反映してもらって CPAN/以下 -をアップデートをすることが望ましいやり方です。CPAN/lib/ に直接変更を加 -えることもあります。CPAN/dist/ はオリジナルを保存する場所なので、変更 -してはいけません。 +んらかのラップ(wrap)をするか、パッチをオリジナルに反映してもらって +CPAN/ 以下をアップデートをすることが望ましいやり方です。CPAN/lib/ に直 +接変更を加えることもありますが、CPAN/dist/ はオリジナルを保存する場所 +なので、変更してはいけません。 </para> <para> @@ -80,7 +81,7 @@ CPAN/ や 3rdparty/ 以下のモジュールを変更したい場合は fml/ 以下で、な <row> <entry> fml/ </entry> - <entry> &fmldevel; プロジェクト直轄 + <entry> &fml8; プロジェクト直轄 </entry> </row> @@ -91,7 +92,7 @@ CPAN/ や 3rdparty/ 以下のモジュールを変更したい場合は fml/ 以下で、な この下のモジュールについては CPAN の説明の通り。 単に標準モジュールでないため、ないしは - &fmldevel; のバージョン管理や保守のために、ここに収容。 + &fml8; のバージョン管理や保守のために、ここに収容。 なお cpan/dist/ @@ -117,7 +118,7 @@ CPAN/ や 3rdparty/ 以下のモジュールを変更したい場合は fml/ 以下で、な <entry> サードパーティ用(予約) 予約されているだけで、 - &fmldevel; プロジェクトとしては使いません。 + &fml8; プロジェクトとしては使いません。 </entry> </row> @@ -130,7 +131,7 @@ CPAN/ や 3rdparty/ 以下のモジュールを変更したい場合は fml/ 以下で、な そのサイト独自に保守したいモジュールをおくための ディレクトリ。 名前を予約されているだけで、 - &fmldevel; プロジェクトとしては使いません。 + &fml8; プロジェクトとしては使いません。 </entry> </row> diff --git a/fml/doc/ja/tutorial/devel/docbook.sgml b/fml/doc/ja/tutorial/devel/docbook.sgml index 358bfdc9..4bf299c7 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.5 2002/07/06 14:55:16 fukachan Exp $ + $FML: docbook.sgml,v 1.6 2003/04/15 14:51:38 fukachan Exp $ --> @@ -9,7 +9,7 @@ </title> <para> -fml-devel (&fmldevel;) のドキュメントでは、SGML の DTD は +&fml8; のドキュメントでは、SGML の DTD は <ulink url="http://www.oasis-open.org/docbook/"> DOCBOOK @@ -72,7 +72,7 @@ HTML のもっと厳密なものだと思って下さい そういった概念をどう表現するべきか？を規定したものが DTD (Data Type Definition)といえます。 DTD は自由に定義すれば良いのですが、かなり大変です。 -誰かが作った DTD コレクションが世の中にはあるので、それを +しかしながら 誰かが作った DTD コレクションが世の中にはあるので、それを 使うのが便利です。 我々は DTD として docbook というものを使う <footnote> @@ -394,7 +394,7 @@ SGML を HTML などに翻訳するために、いくつかのツールが必要です。 </para> <para> -&fmldevel; では、以下のプログラムを使って HTML やテキストファイルを作成し +&fml8; では、以下のプログラムを使って HTML やテキストファイルを作成し ています。 <itemizedlist> @@ -424,7 +424,7 @@ SGML を HTML などに翻訳するために、いくつかのツールが必要です。 <para> もちろん sgmltools がなくても SGML から HTML を作ることができます。 どのツールを使うかは、あなたがどれを便利に思うか？次第です。 -単に &fmldevel; では、sgmltools を歴史的に使っているだけです。 +単に &fml8; では、sgmltools を歴史的に使っているだけです。 </para> <para> @@ -505,7 +505,7 @@ LISP を知らないとちょっと手が出ないでしょう。 </para> <para> -ちなみに &fmldevel; の DSL の記述は +ちなみに &fml8; の DSL の記述は <ulink url="../../../fml/doc/share/sgml/fml.dsl"> fml/doc/share/sgml/fml.dsl diff --git a/fml/doc/ja/tutorial/devel/inet6.sgml b/fml/doc/ja/tutorial/devel/inet6.sgml index 9fbc8cc8..b2feb69a 100644 --- a/fml/doc/ja/tutorial/devel/inet6.sgml +++ b/fml/doc/ja/tutorial/devel/inet6.sgml @@ -1,9 +1,8 @@ <!-- - $FML: inet6.sgml,v 1.3 2001/11/19 14:55:15 fukachan Exp $ + $FML: inet6.sgml,v 1.4 2002/04/01 23:41:02 fukachan Exp $ --> <appendix id="inet6"> - <title> NetBSD 1.5 での IPv6 の設定 </title> diff --git a/fml/doc/ja/tutorial/digest/chapter.sgml b/fml/doc/ja/tutorial/digest/chapter.sgml index 44733040..2b78c1cd 100644 --- a/fml/doc/ja/tutorial/digest/chapter.sgml +++ b/fml/doc/ja/tutorial/digest/chapter.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.sgml,v 1.2 2003/01/05 10:10:20 fukachan Exp $ + $FML: chapter.sgml,v 1.3 2003/04/15 14:51:39 fukachan Exp $ --> + <chapter id="digest"> <title> ダイジェスト/まとめ送り @@ -17,6 +18,7 @@ <warning> <para> まだ、簡易版です。 +&fml4; のようなキメの細かい設定は出来ません。 </para> </warning> @@ -27,8 +29,8 @@ </title> <para> -$ml_home_dir/ 以下のまとめおくり関連ファイルには次のようなものがありま -す。 +$ml_home_dir/ 以下の「まとめおくり関連ファイル」には次のようなものがあ +ります。 <screen> seq-digest members-digest @@ -47,7 +49,7 @@ recipients-digest が、まとめおくりの配送リストです。 <para> $digest_recipient_maps は、もちろん IO::Adapter なので、 -mysql とかも使えます。 +mysql なども利用可能です。 </para> </sect1> @@ -141,12 +143,10 @@ confirm は必要ですかねぇ？これは決めごとなんで、デザインポリシーとして、 </title> <para> -(未実装) <screen> digeston digestoff </screen> -を使えばいいのかな？ </para> </sect2> diff --git a/fml/doc/ja/tutorial/glossary.sgml b/fml/doc/ja/tutorial/glossary.sgml index fd3e6184..c464ebed 100644 --- a/fml/doc/ja/tutorial/glossary.sgml +++ b/fml/doc/ja/tutorial/glossary.sgml @@ -1,9 +1,9 @@ <!-- - $FML: glossary.sgml,v 1.4 2002/07/02 10:39:29 fukachan Exp $ + $FML: glossary.sgml,v 1.5 2003/04/15 14:51:34 fukachan Exp $ --> <glossary id="glossary"> - <title> + <title> 用語集(関数名および変数名関連) </title> @@ -23,13 +23,7 @@ <glossterm> fml-devel </glossterm> <glossdef> <para> - 将来 &fmldevel; になるであろうとおもわれる fml-current - </para> - - <para> - もしかしたら fml 8.x の方が適切かも知れない。 - だが、まだ決まっていない。 - でも 8 じゃないかな〜という感じ濃厚 + &fml8 の開発時の名称。 </para> </glossdef> @@ -131,7 +125,9 @@ <glossdef> <para> 関数へのポインタ( function pointer )。 - ただし perl では CODE リファレンスと呼ぶべき + perl では CODE リファレンスと呼ぶべきだが、 + cr などと書くより分かりやすいので、 + プログラム中では $fp を使うることが多い。 </para> </glossdef> </glossentry> @@ -160,7 +156,7 @@ <glossterm> rなになに </glossterm> <glossdef> <para> - r はリファレンスの略。 + r はリファレンス(reference)の略。 これはハンガリアン記法と呼ばれている。 </para> @@ -229,8 +225,8 @@ $euc_string = STR2EUC($string); <para> メールの本文に fml への命令(コマンド)を書いて送ることで 何らかの処理をしてもらう操作の総称。 - 一般ユーザ用のものと、 - リモート管理用のもの(通称 admin コマンド)の２つのクラスがある。 + 一般ユーザ用のコマンドと、 + リモート管理用のコマンド(通称 admin コマンド)の２つのクラスがある。 </para> </glossdef> </glossentry> diff --git a/fml/doc/ja/tutorial/install/download.sgml b/fml/doc/ja/tutorial/install/download.sgml index 1436713a..20ad3667 100644 --- a/fml/doc/ja/tutorial/install/download.sgml +++ b/fml/doc/ja/tutorial/install/download.sgml @@ -1,10 +1,11 @@ <!-- - $FML: download.sgml,v 1.2 2002/07/06 14:55:17 fukachan Exp $ + $FML: download.sgml,v 1.3 2004/04/07 11:07:05 fukachan Exp $ --> + <chapter id="download"> <title> - &fmldevel; のソースコードをダウンロードする + &fml8; のソースコードをダウンロードする </title> @@ -15,11 +16,11 @@ </title> <para> -fml-devel のソースは +&fml8; のソースは <ulink url="ftp://ftp.fml.org/pub/fml8/"> ftp://ftp.fml.org/pub/fml8/ </ulink> -から、 ftp で入手できます。 +から ftp で入手できます。 </para> <para> @@ -50,7 +51,7 @@ ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/ </title> <para> -anoncvs.fml.org の fmlsrc 以下が &fmldevel; ブランチです。 +anoncvs.fml.org の fmlsrc 以下が &fml8; ブランチです。 </para> <para> diff --git a/fml/doc/ja/tutorial/install/fml_on_nt.sgml b/fml/doc/ja/tutorial/install/fml_on_nt.sgml index 8f98fdce..704cacb9 100644 --- a/fml/doc/ja/tutorial/install/fml_on_nt.sgml +++ b/fml/doc/ja/tutorial/install/fml_on_nt.sgml @@ -1,15 +1,16 @@ <!-- - $FML: fml_on_nt.sgml,v 1.2 2002/07/06 14:55:17 fukachan Exp $ + $FML: fml_on_nt.sgml,v 1.3 2003/04/15 14:51:39 fukachan Exp $ --> + <chapter id="install.fml.nt"> <title> - Microsft 2000/NT 上での &fmldevel; のインストール + Microsft 2000/NT 上での &fml8; のインストール </title> <warning> <para> -まだ、&fmldevel; は動きません。ごめんなさい。 +まだ、&fml8; は動きません。ごめんなさい。 この章はダミーで、「ごめん」っていうためだけにあります。 </para> </warning> diff --git a/fml/doc/ja/tutorial/install/fml_on_unix.sgml b/fml/doc/ja/tutorial/install/fml_on_unix.sgml index d8c0d911..262719f1 100644 --- a/fml/doc/ja/tutorial/install/fml_on_unix.sgml +++ b/fml/doc/ja/tutorial/install/fml_on_unix.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fml_on_unix.sgml,v 1.6 2003/11/24 04:44:57 fukachan Exp $ + $FML: fml_on_unix.sgml,v 1.7 2004/04/07 11:07:05 fukachan Exp $ --> + <chapter id="install.fml.unix"> <title> UNIX 上での fml のインストール @@ -36,7 +37,9 @@ configure を実行する(後述)前に、 <para> configure (GNU autoconf) および make を実行して下さい。 -なお configure の前に、適宜、ユーザ fml とグループ fml を作ってください。 +configure の前に、適宜、ユーザ fml とグループ fml を作っておく必要があ +りますので注意して下さい。 +ここまでの作業をまとめて書くと、次のようになります。 <screen> % su root # groupadd fml @@ -48,7 +51,7 @@ configure が適宜、script 群や .cf 群の変数を書き換えます。 </para> <para> -make install を実行すると、configure が生成する etc/fml/install.cf を +make install を実行すると、configure が生成した etc/fml/install.cf を 元に、configure が生成した install.pl (perl script) がインストールを行 ないます。 </para> @@ -341,13 +344,14 @@ make install はユーザ root で実行して下さい。 必要なら /usr/local/etc/fml/main.cf を編集して下さい。 configure が、あなたの環境に合わせて main.cf を書換えしているはずなの -でconfigure のオプション指定が正しければ、編集の必要は、まずないです。 +で configure のオプション指定が正しければ、編集の必要は、まずないです。 </para> <para> mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共 通の fml の動作指定などは site_default_config.cf の役割です。各ＭＬ固 -有の設定は、各ＭＬのホームディレクトリにあるconfig.cfファイルです。 +有の設定は、各ＭＬのホームディレクトリにある config.cf ファイルを編集 +して下さい。 </para> <!-- main.cf の見本 --> @@ -378,10 +382,10 @@ mani.cf は大枠の最も基本的な設定です。より細かな設定、たとえばサイト共 </para> <para> -デフォルトでは&fml4;兼、見本として:) +デフォルトでは &fml4; と合わせるために、および見本として:) subject のタグをつけない設定とフィルタ関連の設定だけが入っています。 <screen> -# $FML: fml_on_unix.sgml,v 1.6 2003/11/24 04:44:57 fukachan Exp $ +# $FML: fml_on_unix.sgml,v 1.7 2004/04/07 11:07:05 fukachan Exp $ # # site default_config.cf EXAMPLE # diff --git a/fml/doc/ja/tutorial/install/postfix.sgml b/fml/doc/ja/tutorial/install/postfix.sgml index 57f92616..24f60176 100644 --- a/fml/doc/ja/tutorial/install/postfix.sgml +++ b/fml/doc/ja/tutorial/install/postfix.sgml @@ -1,7 +1,8 @@ <!-- - $FML: postfix.sgml,v 1.3 2003/04/15 14:51:39 fukachan Exp $ + $FML: postfix.sgml,v 1.4 2004/04/07 11:07:05 fukachan Exp $ --> + <sect1 id="install.postfix"> <title> メールサーバの設定 (postfix) diff --git a/fml/doc/ja/tutorial/install/qmail.sgml b/fml/doc/ja/tutorial/install/qmail.sgml index 340101d9..fe81d502 100644 --- a/fml/doc/ja/tutorial/install/qmail.sgml +++ b/fml/doc/ja/tutorial/install/qmail.sgml @@ -1,7 +1,8 @@ <!-- - $FML: qmail.sgml,v 1.3 2003/04/15 14:51:39 fukachan Exp $ + $FML: qmail.sgml,v 1.4 2004/04/07 11:07:06 fukachan Exp $ --> + <sect1 id="install.qmail"> <title> メールサーバの設定 (qmail) diff --git a/fml/doc/ja/tutorial/install/upgrade.sgml b/fml/doc/ja/tutorial/install/upgrade.sgml index dcaf82b2..0858d7b6 100644 --- a/fml/doc/ja/tutorial/install/upgrade.sgml +++ b/fml/doc/ja/tutorial/install/upgrade.sgml @@ -1,7 +1,8 @@ <!-- - $FML: upgrade.sgml,v 1.5 2004/03/18 05:42:20 fukachan Exp $ + $FML: upgrade.sgml,v 1.6 2004/04/07 11:07:06 fukachan Exp $ --> + <chapter id="xxxgrade"> <title> fml8 のアップグレード/ダウングレード @@ -32,7 +33,9 @@ fml4 から fml8 へのアップグレードは、 <para> 単に、もう一度 -<link linkend="install.fml.unix">インストール</link> +<link linkend="install.fml.unix"> +インストール +</link> して下さい。 </para> @@ -42,6 +45,11 @@ fml4 から fml8 へのアップグレードは、 ファイルをセーブした瞬間から新しい fml に切り替わります (注: エディタで編集中は古い内容)。 </para> + +<para> +逆に言えば、fml_version 行を編集するまで有効にはなりません。 +</para> + </sect1> diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml index bb2e1140..dd9a61e8 100644 --- a/fml/doc/ja/tutorial/internals/bootloader.sgml +++ b/fml/doc/ja/tutorial/internals/bootloader.sgml @@ -1,15 +1,16 @@ <!-- - $FML: bootloader.sgml,v 1.10 2003/04/15 14:51:40 fukachan Exp $ + $FML: bootloader.sgml,v 1.11 2004/04/07 11:07:06 fukachan Exp $ --> + <chapter id="bootloader"> <title> バージョン依存性を解決するための fml ブートローダ </title> <para> -&fmldevel; にはインストールされている fml のバージョン依存性を考慮するた -めに、本章で述べるようなブートストラップの過程があります。 +&fml8; にはインストールされている fml のバージョン依存性を考慮するため +に、本章で述べるようなブートストラップの過程があります。 <screen> fml (libexec/distribute) が boot していく様子 @@ -144,8 +145,8 @@ FML::Process::Mead >-| | <listitem> <para> Bootstrap2() および ProcessSwitch() を実行し、 - 配送用、コマンドモード用などの各 - プログラム/プロセスなどへ制御を移します(分岐する)。 + 配送用、コマンドメール用の各プロセスへ + 制御を移します(分岐する)。 この時は $0 から自分の名前を知り、 どのプロセスへ分岐すればいいのかを判断しています。 </para> diff --git a/fml/doc/ja/tutorial/internals/cgi.examples.sgml b/fml/doc/ja/tutorial/internals/cgi.examples.sgml index 737cad6d..bb720ff3 100644 --- a/fml/doc/ja/tutorial/internals/cgi.examples.sgml +++ b/fml/doc/ja/tutorial/internals/cgi.examples.sgml @@ -1,11 +1,10 @@ <!-- - $FML: dbms.sgml,v 1.5 2003/05/31 08:51:09 fukachan Exp $ + $FML: cgi.examples.sgml,v 1.1 2004/03/31 06:03:00 fukachan Exp $ 注意: cgi.sgml の中にはめ込むので <chapter> は不必要だ。 --> - <sect1 id="cgi.internal.example.isa"> <title> CGI の実装: CGI 関連クラスの継承関係 @@ -106,7 +105,7 @@ run_cgi_menu() は、入力画面の生成をおこないます。 </para> <para> -この２つはデフォルトのものを使っているという気分です。 +この２つは、たいていデフォルトのものを使っています。 <screen> run_cgi_title FML::Process::CGI::Kernel クラス (タイトル表示) run_cgi_options FML::Process::CGI::Kernel クラス (言語選択画面) diff --git a/fml/doc/ja/tutorial/internals/cgi.sgml b/fml/doc/ja/tutorial/internals/cgi.sgml index 151934ad..f40909b7 100644 --- a/fml/doc/ja/tutorial/internals/cgi.sgml +++ b/fml/doc/ja/tutorial/internals/cgi.sgml @@ -1,7 +1,8 @@ <!-- - $FML: cgi.sgml,v 1.11 2003/04/15 14:51:40 fukachan Exp $ + $FML: cgi.sgml,v 1.12 2004/03/31 06:03:01 fukachan Exp $ --> + <chapter id="cgi.internal"> <title> CGI プロセスの内部構造 diff --git a/fml/doc/ja/tutorial/internals/config.cf.sgml b/fml/doc/ja/tutorial/internals/config.cf.sgml index 67d2460c..a7693a8c 100644 --- a/fml/doc/ja/tutorial/internals/config.cf.sgml +++ b/fml/doc/ja/tutorial/internals/config.cf.sgml @@ -1,7 +1,8 @@ <!-- - $FML: config.cf.sgml,v 1.11 2003/06/20 22:23:14 fukachan Exp $ + $FML: config.cf.sgml,v 1.12 2004/04/07 11:07:07 fukachan Exp $ --> + <chapter id="internal.config.cf"> <title> 設定ファイル config.cf @@ -10,7 +11,9 @@ <!-- ======================================= --> <sect1 id="config.cf"> - <title> ＭＬごとの設定ファイル config.cf </title> + <title> + ＭＬごとの設定ファイル config.cf + </title> <para> 各ＭＬごとにさまざまなカスタマイズをすることができます。 @@ -32,6 +35,11 @@ 形式になっています。 </para> +<para> +perl module と同様に、=cut の後には perl script を書くようになっていま +す。「キーワード = 値」形式の記述は =cut の前に書いて下さい。 +</para> + <sect2> <title> &fml4; の諸問題 diff --git a/fml/doc/ja/tutorial/internals/credential.sgml b/fml/doc/ja/tutorial/internals/credential.sgml index d0020d42..213aea8e 100644 --- a/fml/doc/ja/tutorial/internals/credential.sgml +++ b/fml/doc/ja/tutorial/internals/credential.sgml @@ -1,7 +1,8 @@ <!-- - $FML: credential.sgml,v 1.2 2002/07/23 09:33:13 fukachan Exp $ + $FML: credential.sgml,v 1.3 2003/04/15 14:51:40 fukachan Exp $ --> + <chapter id="credential"> <title> ユーザ認証 @@ -13,8 +14,7 @@ </para> - -<sect1> +<sect1 id="credential.implementation"> <title> 議論: FML::Credential の実装 </title> diff --git a/fml/doc/ja/tutorial/internals/db_modules.sgml b/fml/doc/ja/tutorial/internals/db_modules.sgml index 7aa5d74d..e1f02cf6 100644 --- a/fml/doc/ja/tutorial/internals/db_modules.sgml +++ b/fml/doc/ja/tutorial/internals/db_modules.sgml @@ -1,7 +1,12 @@ <!-- - $FML: db.sgml,v 1.7 2003/04/15 14:51:40 fukachan Exp $ + $FML: db_modules.sgml,v 1.1 2003/05/31 08:51:09 fukachan Exp $ --> +<!-- + XXX-TODO: データベース関連モジュール も書き直した方が… +--> + + <chapter id="db.module"> <title> データベース関連モジュール @@ -39,7 +44,7 @@ message-id のデータを持っていますし、記事の分については重複しています。 <link linkend="threadtrack.db"> Mail::Message::DB </link> -のようなものとし、各種アダプタ層ががんばってほしい。 +のようなものとし、各種アダプタ層が頑張って欲しい。 また、キャッシュの方だが、現在では Tie::JournaledDir もしくは File::CacheDir かのいづれかが使われることとなる。 </para> @@ -72,10 +77,10 @@ DBMS <para> -そういったわけで FML では、expire の仕方に応じて２つのデータ保持クラス -を用意しています。それは「サイズを気にせず、時間を区切って expire する -のか？」もしくは「使用する領域のサイズをある程度気にするか？」の２種類 -です。 +そういったわけで &fml8; では、expire の仕方に応じて２つのデータ保持ク +ラスを用意しています。それは「サイズを気にせず、時間を区切って expire +するのか？」もしくは「使用する領域のサイズをある程度気にするか？」の２ +種類です。 </para> <warning> @@ -203,7 +208,7 @@ first match と last match は切替えることができます。 <para> -このクラスは、あるディレクトリ(例: db/)の有限の複数のファイル郡の中に +このクラスは、あるディレクトリ(例: db/)の有限の複数のファイル群の中に データを蓄えます。 例えば db/ に 1 〜 100 の名前のファイルがつくられ、 順番に使われてきます。 diff --git a/fml/doc/ja/tutorial/internals/dbms.sgml b/fml/doc/ja/tutorial/internals/dbms.sgml index b069ee07..b1a7257b 100644 --- a/fml/doc/ja/tutorial/internals/dbms.sgml +++ b/fml/doc/ja/tutorial/internals/dbms.sgml @@ -1,7 +1,8 @@ <!-- - $FML: dbms.sgml,v 1.4 2003/04/15 14:51:40 fukachan Exp $ + $FML: dbms.sgml,v 1.5 2003/05/31 08:51:09 fukachan Exp $ --> + <chapter id="dbms"> <title> データベース管理システム diff --git a/fml/doc/ja/tutorial/internals/design.sgml b/fml/doc/ja/tutorial/internals/design.sgml index 0f7fa609..a861554e 100644 --- a/fml/doc/ja/tutorial/internals/design.sgml +++ b/fml/doc/ja/tutorial/internals/design.sgml @@ -1,7 +1,8 @@ <!-- - $FML: design.sgml,v 1.9 2003/04/15 14:51:40 fukachan Exp $ + $FML: design.sgml,v 1.10 2004/04/07 11:07:07 fukachan Exp $ --> + <chapter id="design"> <title> 原案: &fml8; (仮名) のデザインコンセプト @@ -45,9 +46,9 @@ http://www.fml.org/software/fml-devel/ <para> 自分がふだん使うには全然困らないのですが、&fml4; との互換性をいいだす -と、まだ多くの機能が実装されていないといえまそう。これは、デザインを最 -初から考え直すに当たり、アイデアや意見を募集するためにまだまだ原型にと -どまっているためでもあります。 +と、まだ多くの機能が実装されていないといえます。これは、デザインを最初 +から考え直すに当たり、アイデアや意見を募集するためにまだまだ原型にとど +まっているためでもあります。 </PARA> <para> diff --git a/fml/doc/ja/tutorial/internals/directory.sgml b/fml/doc/ja/tutorial/internals/directory.sgml index e17eb0e4..407bab82 100644 --- a/fml/doc/ja/tutorial/internals/directory.sgml +++ b/fml/doc/ja/tutorial/internals/directory.sgml @@ -1,7 +1,8 @@ <!-- - $FML: directory.sgml,v 1.3 2003/04/15 14:51:40 fukachan Exp $ + $FML: directory.sgml,v 1.4 2004/04/07 11:07:08 fukachan Exp $ --> + <chapter id="directory"> <title> ディレクトリ @@ -14,8 +15,8 @@ </title> <para> -たとえば、HTML化された記事は、こんな階層に置かれていますが、どうでしょ -う？ +たとえば、HTML化された記事は、 +こんな階層に置かれていますが、どうでしょう？ <screen> 200201/msg○○.html </screen> @@ -31,9 +32,9 @@ </para> <para> -HTML 化されたディレクトリや sub は 1000 ごとに用意すると、例えば -spool/sub/file みたいにすると spool/ 以下で 10^6 ( million )くらいはそ -れなりのアクセス速度を保ちつつ格納できるはず。 +HTML 化されたファイルをおくサブディレクトリを 1000 ごとに用意すると、 +たとえば spool/sub/file みたいにすると、 spool/ 以下で 10^6 ( million ) +くらいはそれなりのアクセス速度を保ちつつ格納できるはず。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/errormail.sgml b/fml/doc/ja/tutorial/internals/errormail.sgml index c03ced91..01c711d3 100644 --- a/fml/doc/ja/tutorial/internals/errormail.sgml +++ b/fml/doc/ja/tutorial/internals/errormail.sgml @@ -1,5 +1,5 @@ <!-- - $FML: errormail.sgml,v 1.4 2004/04/07 11:07:08 fukachan Exp $ + $FML: errormail.sgml,v 1.5 2004/05/22 06:19:49 fukachan Exp $ --> @@ -16,7 +16,11 @@ libexec/error は &fml4; の libexec/mead に相当するものです。 $use_error_mail_analyzer_function を yes にすると、エラー解析機能が有効にな ります。ちなみに、デフォルトで $use_error_mail_analyzer_function は yes つま りエラー解析機能は有効になっています。このへんは &fml4; と異なります。 -&fml8; では、&fml4; でよく使う機能は始めから有効になっています。 +</para> + +<para> +つまるところ、 +&fml8; では &fml4; でよく使う機能は始めから有効になっています。 </para> @@ -78,7 +82,8 @@ $error_mail_analyzer_function_list にある関数名が利用し得るアルゴリズムです。 <para> 単純にエラーの数ですので、たまたま受信者が設定を少しの間だけ間違えてい て、たまたまその日の流量が多い場合には、その受信者はエラーとみなされる -でしょう。そういった場合にも、ようしゃなく削除します。 +でしょう。 +そういった場合にも、ようしゃなく削除するのが、この方法の問題点です。 </para> </sect2> @@ -95,14 +100,19 @@ $error_mail_analyzer_function_list にある関数名が利用し得るアルゴリズムです。 </para> <para> -少なくとも一日一通は流量がないと、このアルゴリズムは動作しませんが、 -ちょっと間違えただけの受信者が削除されることはありません。 +少なくとも一日一通は流量がないと、このアルゴリズムは動作しません。 +よって、ちょっと間違えただけの受信者が削除されることはありません。 </para> <para> 現在のデフォルトは、このアルゴリズムです。 </para> +<para> +注意: とうぜんのことながら、流量が一日一通に満たないような、まったりと +したＭＬでは、このアルゴリズムは動作しません:-) +</para> + </sect2> </sect1> @@ -153,11 +163,11 @@ message/rfc822 一通だけの無味乾燥な mime/multipart です。 <para> そのうち、ヘッダ情報 + そのエラーメールのアドレスの分析レポートとか -なんか付けてやれや〜とかちょっと思ってはいるっす。 +なんか付けてやれや〜とかちょっと思っています。 </para> <para> -リファレンス: fml-devel ML 451 あたりを参照かな。 +リファレンス: fml-devel ML 451 あたりを参照。 </para> </sect1> diff --git a/fml/doc/ja/tutorial/internals/filename.sgml b/fml/doc/ja/tutorial/internals/filename.sgml index d6a0d05a..f3becfed 100644 --- a/fml/doc/ja/tutorial/internals/filename.sgml +++ b/fml/doc/ja/tutorial/internals/filename.sgml @@ -1,10 +1,11 @@ <!-- - $FML$ + $FML: filename.sgml,v 1.3 2003/04/15 14:51:41 fukachan Exp $ --> + <chapter id="filename"> <title> - [&fmldevel; での注意点] ファイル名について + [&fml8; での注意点] ファイル名について </title> <para> diff --git a/fml/doc/ja/tutorial/internals/filter.sgml b/fml/doc/ja/tutorial/internals/filter.sgml index 65e56bf4..b01467a0 100644 --- a/fml/doc/ja/tutorial/internals/filter.sgml +++ b/fml/doc/ja/tutorial/internals/filter.sgml @@ -1,7 +1,13 @@ <!-- - $FML: filter.sgml,v 1.6 2004/04/07 11:07:08 fukachan Exp $ + $FML: filter.sgml,v 1.7 2004/04/20 03:36:34 fukachan Exp $ --> + +<!-- + XXX-TODO: かきなおせよ、ふぃるた +--> + + <chapter id="internals.filter"> <title> フィルタ @@ -54,10 +60,15 @@ text/plain に対してより厳しいシンタックスチェックを行なうフィルタも 非言語依存パート (M$ GUID scanner みたいな) 先頭部分の text/plain パートに対する シンタックスチェック + + 外部フィルタ (ウィルス/SPAM チェッカを呼び出す) + clamav + spamassassin + bogofilter </screen> -本当はこれ以外に、外部の virus scanner なりに飛ばす迂回路が必要だと思 -うんだけど今はまだ考えていません。とりあえず、それは postfix でやって -ください。 +本当はこれ以外に、SMTP もしくは LMTP を使って、外部の virus scanner な +りに飛ばす迂回路(postfix の content_filter 相当)が必要だと思うんだけど +今はまだ考えていません。とりあえず、それは postfix でやってください。 </para> <!-- XXX-TODO トラフィックベースのフィルタ --> @@ -124,13 +135,8 @@ use_機能A = yes <para> コマンドメールには「一通当たりのコマンド数」とか「コマンド依存の制限一 -回のコマンドメールでgetできるファイルは100個まで」といった制限が必要で -しょう。 -</para> - -<para> -TODO: でも、コマンドメールを一行ずつ解析するコード(Mail::Message)のメ -モリ効率がよくない ;)もっと良い方法を考えるべし。 +回のコマンドメールで get できるファイルは100個まで」といったコマンド固 +有の制限があります。 </para> <!-- &table.list.filter.commandmail; --> @@ -151,11 +157,11 @@ text/plain permit text/html reject * permit </screen> -みたいなフォーマットで書きます。 +みたいな空白区切りのフォーマットで書きます。 </para> <para> -MIME が前提なので、!MIME なんてのはない。が、text/plain と +MIME が前提なので、!MIME なんてのはないですが、text/plain と multipart/mixed 中の text/plain を区別するために、こういう書き方である 必要があるとおもうわけです。 <screen> diff --git a/fml/doc/ja/tutorial/internals/hook.sgml b/fml/doc/ja/tutorial/internals/hook.sgml index bc6d63c0..d66de589 100644 --- a/fml/doc/ja/tutorial/internals/hook.sgml +++ b/fml/doc/ja/tutorial/internals/hook.sgml @@ -1,7 +1,8 @@ <!-- - $FML: hook.sgml,v 1.4 2004/05/21 11:55:50 fukachan Exp $ + $FML: hook.sgml,v 1.5 2004/05/22 12:33:49 fukachan Exp $ --> + <chapter id="hook"> <title> HOOK @@ -14,7 +15,7 @@ </title> <para> -hook は微妙な、もしくは複雑なカスタマイズのために是非必要です。 +hook は微妙な修正、もしくは複雑なカスタマイズのために是非必要です。 ですが、実装においてはいくつかの問題があります。 </para> @@ -59,7 +60,7 @@ HOOK の内容 <para> &fml4; と &fml8; の大きなちがいのひとつは変数、関数のスコープです。 &fml4; はグローバルなので、どんな関数でも使えますが、&fml8; では、そう -はいきません。とはいえ、まったくてがかりがないのも困るので、$curproc +はいきません。とはいえ、まったく手がかりがないのも困るので、$curproc が使えるような場所にのみ HOOK を用意するといったルールが必要でしょう。 いまのところ、そういう方針になっています。 </para> diff --git a/fml/doc/ja/tutorial/internals/io_abstraction.sgml b/fml/doc/ja/tutorial/internals/io_abstraction.sgml index e7417f11..0aa6841b 100644 --- a/fml/doc/ja/tutorial/internals/io_abstraction.sgml +++ b/fml/doc/ja/tutorial/internals/io_abstraction.sgml @@ -1,5 +1,5 @@ <!-- - $FML: io_abstraction.sgml,v 1.2 2003/05/26 13:07:26 fukachan Exp $ + $FML: io_abstraction.sgml,v 1.3 2003/05/27 10:59:27 fukachan Exp $ --> @@ -171,8 +171,8 @@ UNIX と異なり、オブジェクトの構造に一定の型があります。型とは RDBMS の <para> また、プライマリキーとなるのは通常メールアドレスです。この前提が多くの -場面で正しいため、メールアドレスをプライマリアドレスにしたテーブル型が -基本的なデータ構造といえるわけです。 +場面で正しいため、メールアドレスをプライマリキーにしたテーブル型が基本 +的なデータ構造といえるわけです。 </para> </sect2> @@ -328,7 +328,8 @@ FML::Error -> FML::Error::Cache -> Tie::JournaledDir </screen> こういったキャッシュのアダプター層のために、標準規格があるとよいです。 全部 Tie でやるってのもあるけど、Tie で書きまくると、どんどん HASH の -中身が複雑になって、一番下の Tie:: の変えがきかなかったりしそう。 +中身が複雑になって、一番下の Tie:: の替えがきかなかったりしそうで、な +んかいやなかんじではあります。 </para> </sect2> diff --git a/fml/doc/ja/tutorial/internals/language.sgml b/fml/doc/ja/tutorial/internals/language.sgml index fe24f7f9..b9c61eec 100644 --- a/fml/doc/ja/tutorial/internals/language.sgml +++ b/fml/doc/ja/tutorial/internals/language.sgml @@ -1,5 +1,5 @@ <!-- - $FML: language.sgml,v 1.1 2004/02/26 10:36:05 fukachan Exp $ + $FML: language.sgml,v 1.2 2004/04/07 11:07:08 fukachan Exp $ --> @@ -29,7 +29,7 @@ </para> <para> -たとえば、Accept-Language: ja などとしてある場合はja が優先だと分かり +たとえば、Accept-Language: ja などとしてある場合は ja が優先だと分かり ます。しかしながら、そういったものがなく、かつ、「日本人が help という メールを送ってきた」場合、返事を us-ascii なのか iso-2022-jp で返すべ きなのか？が、プログラムには良く分かりません。たとえば、こんなメールで @@ -48,9 +48,9 @@ help <para> charsetを素直に考えると、英語で返すべきですが、これは本文が英語だけな -のでcharset=us-asciiになっているだけです。しょうがないので、このＭＬが -(日本人相手のため)日本語優先と設定されているなら、日本語と英語のメッセー -ジ両方を返すべきでしょう。英語のＭＬなら、英語を返すだけでいいです。 +ので charset=us-ascii になっているだけです。しょうがないので、このＭＬ +が(日本人相手のため)日本語優先と設定されているなら、日本語と英語のメッ +セージ両方を返すべきでしょう。英語のＭＬなら、英語を返すだけでいいです。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/lock.sgml b/fml/doc/ja/tutorial/internals/lock.sgml index aab4e2cd..a07d44a3 100644 --- a/fml/doc/ja/tutorial/internals/lock.sgml +++ b/fml/doc/ja/tutorial/internals/lock.sgml @@ -1,5 +1,5 @@ <!-- - $FML: lock.sgml,v 1.2 2003/04/13 04:36:12 fukachan Exp $ + $FML: lock.sgml,v 1.3 2003/04/15 14:51:41 fukachan Exp $ --> @@ -15,20 +15,27 @@ </title> <para> -ながらく giant lock だったが、2003/03 に giant lock をなくした。 +ながらく giant lock でしたが、2003/03 に giant lock をなくしました。 </para> <para> -Mail::Delivery 関連はメンバーリストにアクセスするので、いろいろありそう。 -でも、Mail::Delivery::Queue は見るだけ (mailq コマンド)か、並列操作可 -能なものだけなので、ロックは考えなくて良いはずです。 +現在では、いろいろなりソースごとに、ロックチャンネルが用意されています。 +</para> + +<para> +たとえば、Mail::Delivery 関連はメンバーリストにアクセスするので、いろ +いろとロックが必要です。 </para> <para> -一方、Mail::Delivery::SMTP の操作の際にはメンバーリストのロックが必要 -です。現在は、Mail::Delivery::SMTP を呼び出す FML のクラス(実は -FML::Send と FML::Process::Delivery の２箇所しかない)の中でロック処理 -をしています。 +Mail::Delivery::SMTP の操作の際にはメンバーリストのロックが必要です。 +現在は、Mail::Delivery::SMTP を呼び出す FML のクラス(実は FML::Send と +FML::Process::Delivery の２箇所しかない)の中でロック処理をしています。 +</para> + +<para> +一方、Mail::Delivery::Queue は見るだけ (mailq コマンド)か、並列操作可 +能なものだけなので、ロックは考えなくて良いはずです。 </para> <para> @@ -40,7 +47,13 @@ FML/Command/UserControl.pm FML/Command/Auth.pm には write lock が必要ですが、 FML/Credential.pm -には read lock だけでよさそう。 +は read lock だけでよいです。 +</para> + +<para> +しかしながら、いまのところ reader writer lock は実装されていませんので、 +リソースごとの細かいロック制御で critical region の時間を短くするよう +になっています。 </para> </sect1> diff --git a/fml/doc/ja/tutorial/internals/main.cf.sgml b/fml/doc/ja/tutorial/internals/main.cf.sgml index 19cedf24..7e645b64 100644 --- a/fml/doc/ja/tutorial/internals/main.cf.sgml +++ b/fml/doc/ja/tutorial/internals/main.cf.sgml @@ -1,7 +1,8 @@ <!-- - $FML: main.cf.sgml,v 1.8 2003/04/15 14:51:41 fukachan Exp $ + $FML: main.cf.sgml,v 1.9 2004/04/07 11:07:08 fukachan Exp $ --> + <sect2 id="main.cf"> <title> 例: /usr/local/etc/fml/main.cf @@ -29,7 +30,7 @@ main.cf のフォーマットは他の .cf と同様 <screen> # -# $FML: main.cf.sgml,v 1.8 2003/04/15 14:51:41 fukachan Exp $ +# $FML: main.cf.sgml,v 1.9 2004/04/07 11:07:08 fukachan Exp $ # # fml version diff --git a/fml/doc/ja/tutorial/internals/merge.sgml b/fml/doc/ja/tutorial/internals/merge.sgml index 22b5d504..9364fb68 100644 --- a/fml/doc/ja/tutorial/internals/merge.sgml +++ b/fml/doc/ja/tutorial/internals/merge.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: merge.sgml,v 1.1 2004/03/23 05:16:52 fukachan Exp $ --> + <chapter id="merge.internal.to.fml8"> <title> 他のＭＬシステムの設定を fml8 へ変換する処理について @@ -24,7 +25,8 @@ <para> 1) fml-devel をインストールする。この際、postfix の alias_maps に -/var/spool/ml/etc/mail/aliases を追加する。 +/var/spool/ml/etc/mail/aliases (まだ、この段階では中身のないファイル) +を追加する。 </para> <para> @@ -97,7 +99,9 @@ m=... つまりまとめ行が無効になる。 <para> 同一ドメインで、fml4 と fml8 を半々に使っている場合、 -次のような設定を施しておくのがよいでしょう。 +次のような設定を施しておくとよい？ +いや中途半端なトリックはやめて、 +すなおに、mergeml で変換するか、しないかにしておいた方が無難だと思う。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/restriction.sgml b/fml/doc/ja/tutorial/internals/restriction.sgml index 7896e025..f53f5088 100644 --- a/fml/doc/ja/tutorial/internals/restriction.sgml +++ b/fml/doc/ja/tutorial/internals/restriction.sgml @@ -1,7 +1,8 @@ <!-- - $FML: restriction.sgml,v 1.6 2003/04/12 15:26:36 fukachan Exp $ + $FML: restriction.sgml,v 1.7 2003/04/15 14:51:41 fukachan Exp $ --> + <chapter id="restriction"> <title> 入力データへの制限 @@ -66,7 +67,6 @@ safe_param_*() および try_cgi_*() は安全な値を返すことになっています。 -FML::Restiction の正規表現でチェックされてた後、返される。 </para> <para> @@ -91,7 +91,7 @@ FML::Restriction::Base を継承している)経由でパターンの検査をしています。 <para> もちろん、各モジュールごとの制限は受けます。 たとえば、adduser でアドレスを追加しようとしても、 -アドレスに見えないような文字列を入れれば拒否されます。 +正しいアドレスに見えないような文字列を入れれば拒否されます。 このあたりの制限は各モジュール依存です。 </para> @@ -177,7 +177,6 @@ for my $key (param()) { </sect1> - <sect1> <title> 議論; FML::Restriction の制限はきびし過ぎる？ diff --git a/fml/doc/ja/tutorial/internals/style.sgml b/fml/doc/ja/tutorial/internals/style.sgml index 8be16438..d57af393 100644 --- a/fml/doc/ja/tutorial/internals/style.sgml +++ b/fml/doc/ja/tutorial/internals/style.sgml @@ -1,7 +1,8 @@ <!-- - $FML: style.sgml,v 1.11 2004/03/31 06:29:38 fukachan Exp $ + $FML: style.sgml,v 1.12 2004/04/07 11:07:08 fukachan Exp $ --> + <chapter id="programingstyle"> <TITLE> プログラミング・スタイル @@ -22,9 +23,9 @@ FNF <!-- ==================================================== --> <sect1 id="variable-naming-convention"> -<title> -変数の命名規則（ネーミングコンベンション） -</title> + <title> + 変数の命名規則（ネーミングコンベンション） + </title> <para> default という単語をどこにはさむか？は悩ましいです。 diff --git a/fml/doc/ja/tutorial/internals/userctl.sgml b/fml/doc/ja/tutorial/internals/userctl.sgml index 727169fa..156c0df7 100644 --- a/fml/doc/ja/tutorial/internals/userctl.sgml +++ b/fml/doc/ja/tutorial/internals/userctl.sgml @@ -1,7 +1,8 @@ <!-- - $FML: userctl.sgml,v 1.1 2003/05/12 10:16:40 fukachan Exp $ + $FML: userctl.sgml,v 1.2 2004/04/07 11:07:08 fukachan Exp $ --> + <chapter id="userctl"> <title> ユーザの登録、削除について diff --git a/fml/doc/ja/tutorial/message/chapter.sgml b/fml/doc/ja/tutorial/message/chapter.sgml index 37d29479..c27041f7 100644 --- a/fml/doc/ja/tutorial/message/chapter.sgml +++ b/fml/doc/ja/tutorial/message/chapter.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.sgml,v 1.5 2003/04/15 14:51:42 fukachan Exp $ + $FML: chapter.sgml,v 1.6 2004/04/07 11:07:09 fukachan Exp $ --> + <chapter id="mail.manipulation"> <title> メッセージ(メール)の操作 diff --git a/fml/doc/ja/tutorial/message/discussion.sgml b/fml/doc/ja/tutorial/message/discussion.sgml index 469d1f6e..df221da3 100644 --- a/fml/doc/ja/tutorial/message/discussion.sgml +++ b/fml/doc/ja/tutorial/message/discussion.sgml @@ -1,8 +1,9 @@ <!-- - $FML: discussion.sgml,v 1.3 2002/07/02 10:39:36 fukachan Exp $ + $FML: discussion.sgml,v 1.4 2003/04/15 14:51:42 fukachan Exp $ --> -<sect1> + +<sect1 id="send.back.error.messages"> <title> 議論: エラーメッセージを返す </title> @@ -10,13 +11,15 @@ <para> 適宜、エラーメッセージを送信者に返す必要があります。 それもエラーメッセージは言語依存です。 -何らかの形で言語変換をしてから送り出す必要があるわけです。 +よって、何らかの形で言語変換をしてから送り出す必要があるわけです。 </para> <!-- ===================================================== --> <sect2> - <title> &fml4; の場合 </title> + <title> + &fml4; の場合 + </title> <para> &fml4; では @@ -36,7 +39,7 @@ Mesg() は /usr/local/fml/messages/Japanese/ 以下にあるファイル群に対し <para> 例えば、キーワードが not_found の場合、 /usr/local/fml/messages/Japanese/kern -の not_found という欄が該当します。 +ファイルの not_found という欄が該当します。 </para> </sect2> @@ -45,7 +48,9 @@ Mesg() は /usr/local/fml/messages/Japanese/ 以下にあるファイル群に対し <!-- ===================================================== --> <sect2> - <title> &fmldevel; はどうするべきか？ </title> + <title> + &fmldevel; はどうするべきか？ + </title> <para> 一つのファイルに一つのキーワードを持つのと、 @@ -89,7 +94,7 @@ locale の定義ファイル( </title> <para> -問題の一つは locale に対応するか？という問題です。 +言語問題の一つは locale に対応するか？という問題です。 makefml を筆頭に、各種コマンド群のエラーメッセージの日本語化 を考えると、 locale を考えておくのも悪くはないのかとも思います。 @@ -118,7 +123,7 @@ FML::Message::ja::キーワード <screen> FML::Message::ja::not_found </screen> -などと2、300個のファイルが作られることになります（まじか？）。 +などと2、300個のファイルが作られることになります。 </para> <para> @@ -142,6 +147,10 @@ FML::Message::ja::not_found あたりにあるでしょう。 </para> +<para> +まぁ複数のファイルから一つのファイルを合成するのは簡単なので、 +ばらしておいて問題ないとも考えられます。 +</para> <para> また、各メッセージテンプレートはどのようなものであるべきだろうか？ @@ -164,7 +173,6 @@ locale 化を考えるなら、これはこれで面倒な気がするわけですが… </sect3> - </sect2> </sect1> diff --git a/fml/doc/ja/tutorial/operations/backup.sgml b/fml/doc/ja/tutorial/operations/backup.sgml index 061c0611..0bcca339 100644 --- a/fml/doc/ja/tutorial/operations/backup.sgml +++ b/fml/doc/ja/tutorial/operations/backup.sgml @@ -1,5 +1,5 @@ <!-- - $FML: backup.sgml,v 1.1 2004/03/25 04:10:03 fukachan Exp $ + $FML: backup.sgml,v 1.2 2004/04/07 11:07:10 fukachan Exp $ --> @@ -10,8 +10,8 @@ <para> -fml8 の設定にかんしては、これら(最少で２つ)のディレクトリ以下のファイ -ルをバックアップしておけば良いです。 +&fml8; の設定にかんしては、これら(最少で２つ)のディレクトリ以下のファ +イルをバックアップしておけば良いです。 <screen> /usr/local/etc/fml/ $ml_home_prefix (たとえば /var/spool/ml/、ドメインごとに異なります) @@ -22,12 +22,12 @@ $ml_home_prefix (たとえば /var/spool/ml/、ドメインごとに異なります) <para> また、MTA の設定もバックアップしておくとよいでしょう。 -Postfixなら、/etc/postfixです。 +Postfixなら /etc/postfix です。 </para> <para> -よって、まとめると、その３つ(正確には２＋fml8が管轄しているドメインの -数)のディレクトリということになります。 +まとめると、その３つ(正確には２＋ &fml8; が管轄しているドメインの数)の +ディレクトリということになります。 <screen> /etc/postfix/ /usr/local/etc/fml/ @@ -42,13 +42,13 @@ $ml_home_prefix (たとえば /var/spool/ml/、ドメインごとに異なります) <sect1 id="operations.backup.fml8.include"> <title> - fml8 の設定をバックアップする + &fml8; の設定をバックアップする </title> <para> -fml8 の設定にかんしては、この２つのディレクトリ以下のファイルをバック -アップしておけば良いのですが、ただ、これだと記事やログファイルなどあら -ゆるものが含まれているので、サイズが大きいです。 +&fml8; の設定に関しては、この２つのディレクトリ以下のファイルをバック +アップしておけば良いのですが、ただ、この方法だと記事やログファイルなど +あらゆるものが含まれているので、サイズが大きいです。 <screen> /usr/local/etc/fml/ $ml_home_prefix (たとえば /var/spool/ml/、ドメインごとに異なります) @@ -78,7 +78,7 @@ $ml_home_prefix (たとえば /var/spool/ml/、ドメインごとに異なります) </para> <para> -まず、fml8 では、ファイル名に .cf がついているファイルが設定を書くファ +まず、&fml8; では、ファイル名に .cf がついているファイルが設定を書くファ イルです。正確には <screen> key = value @@ -140,7 +140,7 @@ key = value <sect1 id="operations.backup.fml8.exclude"> <title> - fml8 の設定をバックアップする: 特定のディレクトリ以外、全部 + &fml8; の設定をバックアップする: 特定のディレクトリ以外、全部 </title> <para> diff --git a/fml/doc/ja/tutorial/operations/log.sgml b/fml/doc/ja/tutorial/operations/log.sgml index 3f6562ef..14929366 100644 --- a/fml/doc/ja/tutorial/operations/log.sgml +++ b/fml/doc/ja/tutorial/operations/log.sgml @@ -1,5 +1,5 @@ <!-- - $FML$ + $FML: log.sgml,v 1.1 2003/11/29 12:51:36 fukachan Exp $ --> @@ -22,6 +22,10 @@ で、最近のログ(デフォルトでは 30 行分)が表示されます。 </para> +<para> +GUI からも log コマンドを実行可能です。 +</para> + </sect1> @@ -31,8 +35,8 @@ </title> <para> -別のコマンドや独自のCGIなどからfml CUIを呼びだし処理をさせたい場合、 -STDERRなどでログを受けとりたいことがあります。 +別のコマンドや独自の CGI などから &fml8; CUI を呼びだし処理をさせたい +場合に STDERR などでログを受けとりたいことがあります。 </para> <para> @@ -41,12 +45,12 @@ STDERRなどでログを受けとりたいことがあります。 % makefml --log-computer-output コマンド ＭＬ名 % fml --log-computer-output ＭＬ名 コマンド </screen> -とすると、コマンドの結果が標準出力(STDOUT)へ、 -ログがSTDERRへ出力されます。 +とすると、コマンドの結果が標準出力( STDOUT )へ、 +ログが STDERR へ出力されます。 </para> <para> -たとえば +たとえば次のようになります。 <screen> % fml --log-computer-output elena@fml.org list rudo@nuinui.net @@ -64,20 +68,22 @@ config.cf などで <screen> use_log_computer_output = yes </screen> -と指定することでも可能です。でも、単にこの変数を yes にすると、 -makefml や fml だけでなく、配送やコマンドメールのプログラムも -STDERRにログの出力をしてしまいます。 +と指定することでも同じ効果となります。 +</para> + +<para> +しかしながら、この変数を yes にすると、makefml や fml だけでなく、配送 +やコマンドメールのプログラムもSTDERRにログの出力をしてしまいますので注 +意が必要です。 </para> <para> メッセージのキューイングの内部構造や出力フォーマットは、ある perl module のなかに押し込めてあります。このモジュール(デフォルトは -FML::Log::Print::Simple)は log_computer_output_engine 変数で指定可能で -す。出力を切替えたい場合は、自分用のモジュールを作り、それを、この変数 -に指定してください。 -モジュールは -FML::Log::Print::Simple -を参考に、hack してみてください:) +FML::Log::Print::Simple)は config.cf で log_computer_output_engine を +変数を使えば変更可能です。出力を切替えたい場合は、自分用のモジュールを +作り、それを、この変数に指定してください。モジュールは +FML::Log::Print::Simpleを参考に、hack してみてください:) </para> </sect1> diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml index 3ad0ade1..13f964c4 100644 --- a/fml/doc/ja/tutorial/overview/fml.sgml +++ b/fml/doc/ja/tutorial/overview/fml.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fml.sgml,v 1.4 2003/04/15 14:51:43 fukachan Exp $ + $FML: fml.sgml,v 1.5 2004/04/07 11:07:10 fukachan Exp $ --> + <chapter id="overview.fml"> <title> &fmldevel; の概要 @@ -75,6 +76,7 @@ リモート管理者の登録/削除、 ログを見る、 メンバーリストを見る。 + 設定ファイルの編集機能が未実装です。 </para> </listitem> @@ -114,6 +116,7 @@ <link linkend="error.internal"> エラーメールの自動解析 </link> + 、エラーになるアドレスの自動削除。 </para> </listitem> @@ -166,6 +169,14 @@ <listitem> <para> + 2004 夏以降: 配送キュー管理システムにより再送処理。 + 事実上 MTA の役割をしている。 + </para> + </listitem> + + + <listitem> + <para> <link linkend="module.io.adapter"> 抽象化 IO 層 </link> @@ -353,6 +364,13 @@ elena@fml.org ＭＬを作るには の場合は、ＭＬのアドレスを全部指定して下さい。 たとえば elena@nuinui.net を作る場合は、次のように実行します。 <screen> +初回 +% su root +% makefml newdomain nuinui.net /some/where/nuinui.net +% su fml +% makefml newml elena@nuinui.net + +二回目以降 % su fml % makefml newml elena@nuinui.net </screen> @@ -473,8 +491,10 @@ elena ＭＬの設定のカスタマイズは <link linkend="internal.config.cf"> フォーマットは postfix の設定ファイル </link> -と同様です(&fml4; の config.ph よりは cf にやや近いですが、フォーマッ -トが違うことに変わりはない)。 +とかなり似ています(&fml4; の config.ph よりは cf にやや近いですが、フォー +マットが違うことに変わりはない)。 +HOOK (perl script)を各場合は、 +(perl script ファイルのように) =cut より後に書いて下さい。 </para> <para> @@ -486,7 +506,7 @@ elena ＭＬの設定のカスタマイズは </screen> というファイル中で定義されています。 これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように -バージョン番号付のディレクトリに置かれるのと似ています。 +バージョン番号付のディレクトリに置かれるのと少し似ています。 </para> <para> diff --git a/fml/doc/ja/tutorial/overview/ml.sgml b/fml/doc/ja/tutorial/overview/ml.sgml index 5150e98e..980de444 100644 --- a/fml/doc/ja/tutorial/overview/ml.sgml +++ b/fml/doc/ja/tutorial/overview/ml.sgml @@ -1,12 +1,14 @@ <!-- - $FML: ml.sgml,v 1.2 2002/07/04 10:59:01 fukachan Exp $ + $FML: ml.sgml,v 1.3 2003/04/15 14:51:43 fukachan Exp $ --> + <chapter id="overview.ml"> <title> ＭＬとは？ </title> + <sect1 id="overview.email"> <title> 電子メール diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml index 3aee81f1..b4c88f01 100644 --- a/fml/doc/ja/tutorial/preface.sgml +++ b/fml/doc/ja/tutorial/preface.sgml @@ -1,5 +1,5 @@ <!-- - $FML: preface.sgml,v 1.19 2004/04/02 04:53:40 fukachan Exp $ + $FML: preface.sgml,v 1.20 2004/04/07 11:06:58 fukachan Exp $ --> @@ -11,7 +11,7 @@ <sect1 id="status"> <title> - fml-devel の現状 + &fml8; プロジェクトの現状 </title> @@ -77,8 +77,8 @@ sendmail と postfix のような関係と思って下さい。 にメンバーファイルを書く」というデザインです。これは最初のバージョンか ら継承され続けている基本構造です。しかしながら、RDBMS との連携や冗長化 構成を考えると問題があります。「NFS の時はどうする？」「トラブルチケッ -トシステムと連動したい場合は？」「SQL サーバとも連動したいですね？」う〜 -ん… +トシステムと連動したい場合は？」「SQL サーバとも連動したいですね？」 +などなど… </para> <para> @@ -143,7 +143,7 @@ fml 1.2 相当の最低限の機能 + 自動 HTML 化機構 </screen> が動くことになるでしょう -(というか、これらの機能はすでに動いていて一年以上、複数の環境で動作確 +(というか、これらの機能はすでに動いていて３年以上、複数の環境で動作確 認がされています)。 </para> @@ -164,11 +164,11 @@ fml 1.2 相当の最低限の機能 </para> <para> -そのため 4.0 系は fml project 全体の中で、相対的に stable に近い +そのため 4.0 系は fml プロジェクト全体の中で、相対的に stable に近い current という位置付けになります。4.0 の bug fix は 4.0.x (4.0.1 4.0.2 …)としてまとめられリリースされていく予定です。 また 4.0-current は 4.0.x のためのテストケースであり、 -&fml8; は本当の開発コード( fml-current )という位置付けといえます。 +&fml8; が本当の開発コード( fml-current )という位置付けといえます。 <screen> fml-devel -----------------------------> 8.0 ? (次世代プロジェクトの目標) @@ -180,7 +180,7 @@ current という位置付けになります。4.0 の bug fix は 4.0.x (4.0.1 4.0.2 </para> <para> -&fml8; 用に作られたモジュールを &fml4; へ輸入する予定です。 +また、&fml8; 用に作られたモジュールを &fml4; へ輸入する予定です。 たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)や、 スレッド追跡システムです。 これは &fml8; の機能を 4.0 でテストをするいう意味あいもあります。 diff --git a/fml/doc/ja/tutorial/setup/apache.sgml b/fml/doc/ja/tutorial/setup/apache.sgml index 323a3b92..4b310f0c 100644 --- a/fml/doc/ja/tutorial/setup/apache.sgml +++ b/fml/doc/ja/tutorial/setup/apache.sgml @@ -1,5 +1,5 @@ <!-- - $FML: apache.sgml,v 1.1 2004/10/02 14:29:46 fukachan Exp $ + $FML: apache.sgml,v 1.2 2004/10/03 10:55:15 fukachan Exp $ --> @@ -31,6 +31,7 @@ fml8 CGI の内部構造については suexec 利用可能な apache を作る必要があります。 configure を実行する際に、 <screen> +(apache 1.x の場合) configure --enable-suexec --suexec-caller=www </screen> などとします。 @@ -40,8 +41,10 @@ configure --enable-suexec --suexec-caller=www <para> インストール後、~ユーザ/cgi-bin/ を許すように httpd.conf を -設定する必要があります。 +変更する必要があります。 <screen> +設定例: + <Directory /home/*/*/public_html> AllowOverride FileInfo AuthConfig Limit Options MultiViews Indexes SymLinksIfOwnerMatch IncludesNoExec ExecCGI diff --git a/fml/doc/ja/tutorial/setup/cgi.sgml b/fml/doc/ja/tutorial/setup/cgi.sgml index d0fdefd3..571bc298 100644 --- a/fml/doc/ja/tutorial/setup/cgi.sgml +++ b/fml/doc/ja/tutorial/setup/cgi.sgml @@ -1,5 +1,5 @@ <!-- - $FML: cgi.sgml,v 1.5 2004/03/31 06:29:00 fukachan Exp $ + $FML: cgi.sgml,v 1.6 2004/10/02 14:29:46 fukachan Exp $ --> @@ -20,20 +20,23 @@ CGI の内部構造については </para> <para> -<link linkend="setup.apache.suexec">apache で suexec を使う</link> +<link linkend="setup.apache.suexec"> +apache で suexec を使う +</link> ことを前提としています。 </para> <para> -2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI は、 -あります。ユーザの追加、削除、メンバーリストやログの閲覧などが可能です -が、CGI からの設定変更インターフェイス( config.cf の編集機能)が未実装 -です。 +2004 年、秋現在、ＭＬごとの CGI およびドメイン全体を管理する CGI が用 +意されています。このインターフェイスで、ユーザの追加、削除、メンバーリ +ストやログの閲覧などが可能ですが、CGI からの設定変更インターフェイス( +config.cf の編集機能)が未実装です。 </para> <para> -なお、CGI を使う場合でも、メールサーバとして postfix や qmail を使って -いるなら、CGI 用の特別な「メールサーバの設定変更」は不要です。 +なお、CGI から設定変更を行なう場合でも、メールサーバとして postfix や +qmail を使っているなら、CGI 用の特別な「メールサーバの設定変更」は不要 +です。 </para> </warning> @@ -41,14 +44,14 @@ CGI の内部構造については <sect1 id="setupcgi.install"> <title> - いつでも makefml newml は CGI スクリプトを作っています + いつでも makefml newml は CGI スクリプトを作ります </title> <para> makefml newml を実行するとデフォルトで config.cgi などの CGI スクリプ トが ~fml/public_html/ 以下に用意されています。この CGI は二種類あり、 -ドメイン全体を管理するものとそれぞれのＭＬを管理する CGI と両方ありま -す。 +ドメイン全体を管理する CGI と、それぞれのＭＬを管理する CGI と両方あり +ます。 <screen> そのドメインのＭＬ全部の管理者用 ~fml/public_html/fml/ドメイン/admin/config.cgi @@ -74,8 +77,7 @@ http://lists.fml.org/~fml/cgi-bin/fml/ドメイン/ml-admin/ＭＬ名/config.cgi 例 http://lists.fml.org/~fml/cgi-bin/fml/fml.org/ml-admin/elena/config.cgi </screen> -の両方が makefml により用意されます -(後者はそういう予定ということで、実際には作られません _o_)。 +の両方が makefml により用意されます。 </para> <para> @@ -104,6 +106,12 @@ http://lists.fml.org/~fml/cgi-bin/fml/fml.org/.htaccess <para> デフォルトの .htaccess は次のような無意味:)なものになっていて、 アクセスできません。 +<footnote> +<para> +さらに、デフォルトの apache では ~fml/ へのアクセスは出来ないはずなの +で、apache の設定も別途必要です。一応、この二段構えになっています。 +</para> +</footnote> <screen> AuthName ByPassword AuthType Basic @@ -122,10 +130,10 @@ require valid-user <warning> <para> -(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになります。 -デバッグする場合はともかく、そういう裏技は使わないようにしましょう;-) -また、そういうのに限って再設定し忘れたりするものなので、しない方が良い -です。きちんと .htaccess を設定しましょう。 +(当たり前だけど)このファイルを消すと、誰でもアクセスできるようになりま +す。デバッグする場合はともかく、そういう裏技は使わないようにしましょう;-) +また、そういうデバッグなんて時に限って、そのまま再設定し忘れたりするも +のなので、しない方が良いです。きちんと .htaccess を設定しましょう。 </para> </warning> diff --git a/fml/doc/ja/tutorial/setup/config.cf.sgml b/fml/doc/ja/tutorial/setup/config.cf.sgml index 88ee08da..4c06a4d7 100644 --- a/fml/doc/ja/tutorial/setup/config.cf.sgml +++ b/fml/doc/ja/tutorial/setup/config.cf.sgml @@ -1,7 +1,8 @@ <!-- - $FML: config.cf.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $ + $FML: config.cf.sgml,v 1.4 2004/04/07 11:07:11 fukachan Exp $ --> + <sect1 id="setup.config.cf"> <title> 設定ファイル config.cf のカスタマイズ @@ -11,8 +12,9 @@ makefml は、 makefml newml を実行した際に、 そのＭＬの config.cf などの設定ファイル群を一式を作り、 -さらに、MTA がfml を起動する際に使う include 類( postfix 用)および~ -fml/.qmail-* ( qmail 用)など必要な設定ファイル一式を用意します。 +さらに、MTA が fml を起動する際に使う include 類( postfix 用)および +~fml/.qmail-* ( qmail 用 ) +などの必要な設定ファイル一式を用意します。 <screen> % su fml % makefml newml elena @@ -43,15 +45,15 @@ config.cf の先頭の ml_domain と ml_name もコメントになっていますが、そ <screen> "| /usr/local/libexec/fml/distribute elena@fml.org" </screen> -そして、/var/spool/ml/elena/include-ctl ファイルは +そして /var/spool/ml/elena/include-ctl ファイルは <screen> "| /usr/local/libexec/fml/command elena@fml.org" </screen> -などとなっています。MTAから起動された +などとなっています。MTA から起動された /usr/local/libexec/fml/distribute -コマンドなどが、このコマンド引数の elena@fml.org の部分からml_domain -と ml_name を自動的に設定します。そのため config.cf ではコメントのまま -で問題ありません。 +コマンドなどが、このコマンド引数の elena@fml.org の部分から +ml_domain と ml_name を自動的に設定します。 +そのため config.cf ではコメントのままで問題ありません。 </para> <para> diff --git a/fml/doc/ja/tutorial/setup/newml.recipes.sgml b/fml/doc/ja/tutorial/setup/newml.recipes.sgml index 8dc4c5da..587b25f5 100644 --- a/fml/doc/ja/tutorial/setup/newml.recipes.sgml +++ b/fml/doc/ja/tutorial/setup/newml.recipes.sgml @@ -1,5 +1,5 @@ <!-- - $FML: newml.recipes.sgml,v 1.1 2003/12/21 03:19:14 fukachan Exp $ + $FML: newml.recipes.sgml,v 1.2 2004/04/07 11:07:11 fukachan Exp $ --> @@ -33,7 +33,7 @@ $newml_command_ml_admin_default_address デフォルトでは、どのＭＬでも /usr/local/etc/fml/main.cf で定義されてい る管理者のアドレス $fml_owner が使われます。 -それ以外のものにしたい場合、 +それ以外のものにしたい場合、site_default_config.cf で $newml_command_ml_admin_default_address にメールアドレスを設定して下さい。 <screen> diff --git a/fml/doc/ja/tutorial/setup/newml.sgml b/fml/doc/ja/tutorial/setup/newml.sgml index c7475235..41f2f1ab 100644 --- a/fml/doc/ja/tutorial/setup/newml.sgml +++ b/fml/doc/ja/tutorial/setup/newml.sgml @@ -1,5 +1,5 @@ <!-- - $FML: newml.sgml,v 1.6 2003/12/21 03:19:14 fukachan Exp $ + $FML: newml.sgml,v 1.7 2004/04/07 11:07:11 fukachan Exp $ --> @@ -134,19 +134,27 @@ makefml newdomain コマンドでパスを指定して下さい。 makefml を使ってＭＬを作成します。 使い方は &fml4; と同様ですが、ＭＬ名にきちんとドメインまでつけて下さい。 <screen> +初回は、newdomain コマンドによるドメイン定義も必要です。 % su root # makefml newdomain nuinui.net /var/spool/virtual/nuinui.net # exit % su fml % makefml newml elena@nuinui.net + +二回目以降の場合は + +% su fml +% makefml newml elena@nuinui.net + +だけでよいです。 </screen> </para> <para> -newdomainコマンドでは、ドメインと使うml_home_prefixディレクトリのペア -を指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファイ -ルの編集を代行します。上の例では ml_home_prefix ファイルに次の行を追加 -します。 +newdomainコマンドでは、ドメインと使う ml_home_prefix ディレクトリのペ +アを指定します。このコマンドは /usr/local/etc/fml/ml_home_prefix ファ +イルの編集を代行します。上の例では ml_home_prefix ファイルに次の行を追 +加します。 <screen> nuinui.net /var/spool/virtual/nuinui.net </screen> diff --git a/fml/doc/ja/tutorial/setup/procmail.sgml b/fml/doc/ja/tutorial/setup/procmail.sgml index ad5cf285..0aaacf34 100644 --- a/fml/doc/ja/tutorial/setup/procmail.sgml +++ b/fml/doc/ja/tutorial/setup/procmail.sgml @@ -1,7 +1,8 @@ <!-- - $FML: procmail.sgml,v 1.3 2003/04/15 14:51:44 fukachan Exp $ + $FML: procmail.sgml,v 1.4 2004/04/07 11:07:12 fukachan Exp $ --> + <sect1 id="setup.procmail"> <title> 自分のアカウントでＭＬを行ないたい @@ -20,10 +21,10 @@ </para> <para> -こういった場合、&fmldevel; ではユーザが procmail などの振分ツールを使 -うだろうと期待しています:-)そのため、&fmldevel; に振り分けツールは用意 -されていません。OS のパッケージシステムなどを使って振り分けツールをイ -ンストールして下さい。 +こういった場合、&fml8; ではユーザが procmail などの振分ツールを使うだ +ろうと期待しています:-)そのため、&fml8; に振り分けツールは用意されてい +ません。OS のパッケージシステムなどを使って振り分けツールをインストー +ルして下さい。 </para> <para> diff --git a/fml/doc/ja/tutorial/setup/qmail.sgml b/fml/doc/ja/tutorial/setup/qmail.sgml index 48b06f59..67708a5a 100644 --- a/fml/doc/ja/tutorial/setup/qmail.sgml +++ b/fml/doc/ja/tutorial/setup/qmail.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: qmail.sgml,v 1.2 2002/07/06 14:55:20 fukachan Exp $ --> + <sect1 id="setup.qmail.aliases"> <title> メールサーバの設定 (qmail) diff --git a/fml/doc/ja/tutorial/setup/test.sgml b/fml/doc/ja/tutorial/setup/test.sgml index 8abd2797..8750ed00 100644 --- a/fml/doc/ja/tutorial/setup/test.sgml +++ b/fml/doc/ja/tutorial/setup/test.sgml @@ -1,7 +1,8 @@ <!-- - $FML: test.sgml,v 1.4 2003/04/15 14:51:44 fukachan Exp $ + $FML: test.sgml,v 1.5 2004/04/07 11:07:12 fukachan Exp $ --> + <chapter id="test"> <title> テスト @@ -28,7 +29,7 @@ <warning> <para> テストの前に -newml の際の重複チェックを効かせるために +newml の際のユーザ重複チェックを効かせるために postfix の aliases をきちんと追加して下さい。 これをしないと root ＭＬとか作れちゃいます:-) </para> @@ -59,7 +60,7 @@ qmail をメールサーバに使っている人は特にやることはないとおもいます。 <para> まず、メールサーバに個人宛のメールアドレスを用意しましょう。 -ここでは、ユーザるどくん rudo@fml.org とします。 +ここでは、ユーザ「るど」くん rudo@fml.org を例にとります。 <footnote> <para> 簡単に用意するには、ユーザ rudo くんを作ればよいでしょう。 diff --git a/fml/doc/ja/tutorial/troubleshoot/filesystem.sgml b/fml/doc/ja/tutorial/troubleshoot/filesystem.sgml index d8a57e10..718dc05e 100644 --- a/fml/doc/ja/tutorial/troubleshoot/filesystem.sgml +++ b/fml/doc/ja/tutorial/troubleshoot/filesystem.sgml @@ -1,5 +1,5 @@ <!-- - $FML: filesystem.sgml,v 1.2 2004/06/22 09:30:43 fukachan Exp $ + $FML: filesystem.sgml,v 1.3 2004/06/23 15:08:34 fukachan Exp $ --> @@ -10,7 +10,7 @@ <para> 基本的には、MTAによる再送処理が行なわれるように &fml8; が異常終了するか、 -&fml8; 自身が頑張って配送処理を行なうか？のしょりしかありません。 +&fml8; 自身が頑張って配送処理を行なうか？の処理となります。 &fml8; 自身が頑張る場合、 ログファイルやサマリファイルには欠落が出得るが、 投稿された記事の内容が失われることだけはないつもりです。 @@ -38,6 +38,11 @@ MTA に再挑戦してもらうため、exit(EX_TEMPFAIL)でプロセスを異常終了させます。 を参照してください。 </para> +<para> +このとき、incoming queue には中途半端にメールが書き込まれたファイルが +残り得ます。このキューは、あとでキュー管理システムにより削除されます。 +</para> + </sect2> @@ -69,16 +74,22 @@ MTA から &fml8; を再呼出してもらうようにします。 記事の保存の際にエラーになった場合 </title> +<caution> +<para> +この処理を開始する時、すでに記事番号は更新されています。 +</para> +</caution> + <para> 記事の書き込みはできませんが、オリジナルのメールは既にディスクに書き込 まれています。記事の方は、ヘッダ部分には色々と追加がありますが、本文は -オリジナルメールのものと一緒です。そこで、キューディレクトリから -「spool/割り当てられた記事番号」ファイルへlink(2)することで、記事の内 -容だけは保存するようにします。 +オリジナルメールのものと一緒です。そこで、incoming queue ディレクトリ +から「spool/割り当てられた記事番号」ファイルへlink(2)することで、記事 +の内容だけは保存するようにします。 <footnote> <para> さらに、記事ファイルにヘッダをつけてあげるコマンドが別途あるとよいでしょ -うね。とりあえず、未実装ですが。 +うね。でも、未実装です。 </para> </footnote> </para> @@ -89,8 +100,8 @@ MTA から &fml8; を再呼出してもらうようにします。 </para> <para> -ただ、このときはメールキューに書き込めないため、もし配送過程でエラーが -生じた場合、配送は中途半端に終了となります。 +ただ、このときは( outgoing )メールキューに書き込めないため、もし配送過 +程でエラーが生じた場合、配送は中途半端に終了となります。 </para> </sect2> @@ -102,19 +113,21 @@ MTA から &fml8; を再呼出してもらうようにします。 </title> <para> -配送するべき内容をキューに書き、書き込み成功後に配送処理が行なわれます。 +配送するべき内容を( outgoing )キューに書き、書き込み成功後に配送処理が +行なわれます。 </para> <para> キューに書き込めない場合、メモリ上のデータの配送を試みますが、 配送過程でエラーが生じた場合、配送は中途半端に終了となります。 -</para> - +<footnote> <para> トリッキーな拡張が必要ではありますが、ちゃんとキューイングをフェイクで きる仕組みが必要でしょう。たとえば、別の（のちに起動された）プロセスが、 -この記事のメールキューを再生成して配送キューにいれるを試みるように拡張 -するべきなのでしょう。この部分は未実装です。 +この記事のメールキューを再生成して配送キューにいれる試みをするように拡 +張するなどと、するべきなのでしょう。この部分は未実装です。 +</para> +</footnote> </para> <para> diff --git a/fml/doc/ja/tutorial/troubleshoot/recipe.listup.addresses.sgml b/fml/doc/ja/tutorial/troubleshoot/recipe.listup.addresses.sgml index 0d459b3e..d3252913 100644 --- a/fml/doc/ja/tutorial/troubleshoot/recipe.listup.addresses.sgml +++ b/fml/doc/ja/tutorial/troubleshoot/recipe.listup.addresses.sgml @@ -1,7 +1,8 @@ <!-- - $FML: recipe.listup.addresses.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $ + $FML: recipe.listup.addresses.sgml,v 1.2 2003/04/15 14:51:45 fukachan Exp $ --> + <qandaentry> <question> <para> diff --git a/fml/doc/ja/tutorial/troubleshoot/recipe.listup.aliases.sgml b/fml/doc/ja/tutorial/troubleshoot/recipe.listup.aliases.sgml index c7fbe4cf..1b5e6c56 100644 --- a/fml/doc/ja/tutorial/troubleshoot/recipe.listup.aliases.sgml +++ b/fml/doc/ja/tutorial/troubleshoot/recipe.listup.aliases.sgml @@ -1,7 +1,8 @@ <!-- - $FML: recipe.version.sgml,v 1.2 2002/10/29 04:10:08 fukachan Exp $ + $FML: recipe.listup.aliases.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $ --> + <qandaentry> <question> <para> diff --git a/fml/doc/ja/tutorial/troubleshoot/recipe.version.sgml b/fml/doc/ja/tutorial/troubleshoot/recipe.version.sgml index 62ca3a92..accd134d 100644 --- a/fml/doc/ja/tutorial/troubleshoot/recipe.version.sgml +++ b/fml/doc/ja/tutorial/troubleshoot/recipe.version.sgml @@ -1,7 +1,8 @@ <!-- - $FML: recipe.version.sgml,v 1.3 2002/11/09 14:15:53 fukachan Exp $ + $FML: recipe.version.sgml,v 1.4 2003/04/15 14:51:45 fukachan Exp $ --> + <qandaentry> <question> <para> diff --git a/fml/doc/ja/tutorial/usage/chaddr.sgml b/fml/doc/ja/tutorial/usage/chaddr.sgml index 6477fc99..95d4164d 100644 --- a/fml/doc/ja/tutorial/usage/chaddr.sgml +++ b/fml/doc/ja/tutorial/usage/chaddr.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chaddr.sgml,v 1.1 2002/07/28 12:20:19 fukachan Exp $ + $FML: chaddr.sgml,v 1.2 2003/04/15 14:51:45 fukachan Exp $ --> + <sect1 id="usage.user.chaddr"> <title> メールアドレスを変更する diff --git a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml index 36e6facd..337ea4c1 100644 --- a/fml/doc/ja/tutorial/usage/chapter.onhost.sgml +++ b/fml/doc/ja/tutorial/usage/chapter.onhost.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.onhost.sgml,v 1.9 2004/02/26 05:29:59 fukachan Exp $ + $FML: chapter.onhost.sgml,v 1.10 2004/04/07 11:07:12 fukachan Exp $ --> + <chapter id="usage.onhost"> <title> ＭＬサーバのホスト上でコマンドを使うと(ＭＬ管理者に)できること @@ -48,9 +49,9 @@ makefml を使う操作は confirmation が不要です。makefml を実行できる時点 <para> そのためファイルの直接編集などはせずに、通常は「makefml ( -/usr/local/bin/makefml )を使うことで fml の設定を変更して下さい」とい -うポリシーが推奨されています。もちろんファイルを編集しても構いませんが、 -内部構造などを良く理解してからにしてください。 +/usr/local/bin/makefml )コマンドを使うことで fml の設定を変更して下さ +い」というポリシーが推奨されています。もちろんファイルを編集しても構い +ませんが、内部構造などをよく理解してからにしてください。 </para> <para> diff --git a/fml/doc/ja/tutorial/usage/chapter.user.sgml b/fml/doc/ja/tutorial/usage/chapter.user.sgml index 2ce9e16a..35212fad 100644 --- a/fml/doc/ja/tutorial/usage/chapter.user.sgml +++ b/fml/doc/ja/tutorial/usage/chapter.user.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.user.sgml,v 1.1 2002/07/28 10:51:12 fukachan Exp $ + $FML: chapter.user.sgml,v 1.2 2002/07/28 12:20:19 fukachan Exp $ --> + <chapter id="usage.user"> <title> ＭＬのメンバーができること diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml index 48e7d70e..6f0f56f1 100644 --- a/fml/doc/ja/tutorial/usage/command.sgml +++ b/fml/doc/ja/tutorial/usage/command.sgml @@ -1,7 +1,8 @@ <!-- - $FML: command.sgml,v 1.7 2003/04/15 14:51:46 fukachan Exp $ + $FML: command.sgml,v 1.8 2004/04/07 11:07:13 fukachan Exp $ --> + <sect1 id="fml.command.bymail"> <title> コマンドメール (fml をメールで操作する) @@ -25,10 +26,11 @@ makefml を使えるということは、ＭＬサーバのホストのシェルが取れている、 </para> <para> -一方、コマンドメールなどで一般ユーザに提供する機能は制限するべきです。 -実際、ユーザに提供されているコマンド操作は makefml で可能な操作のごく -一部です。つまり、コマンドメールとは makefml のコマンドの一部を使えな -くし、適宜 confirmation を付け加えたコマンド体系といってよいでしょう。 +一方、コマンドメールなどで一般ユーザに提供する機能には、いろいろな制限 +をかけるべきです。実際、ユーザに提供されているコマンド操作は makefml +で可能な操作のごく一部です。つまり、コマンドメールとは makefml のコマ +ンドの一部を使えなくし、適宜 confirmation を付け加えたコマンド体系といっ +てよいでしょう。 </para> </important> @@ -50,7 +52,7 @@ command はメールを標準入力から受けとり、 <warning> <para> -&fml4; と違い、&fmldevel; ではコマンドの結果を +&fml4; と違い、&fml8; ではコマンドの結果を <link linkend="message.reply"> 一通のメール ( MIME/Multipart )にまとめて返送 </link> @@ -67,7 +69,7 @@ command はメールを標準入力から受けとり、 </title> <para> -&fmldevel; では +&fml8; では <screen> メールによるコマンド処理 makefml によるコマンド処理 @@ -80,5 +82,3 @@ CGI でのコマンド処理 </sect2> </sect1> - - diff --git a/fml/doc/ja/tutorial/usage/fml.sgml b/fml/doc/ja/tutorial/usage/fml.sgml index dd35ce4d..1c31cbf9 100644 --- a/fml/doc/ja/tutorial/usage/fml.sgml +++ b/fml/doc/ja/tutorial/usage/fml.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: fml.sgml,v 1.1 2003/01/05 08:03:23 fukachan Exp $ --> + <sect1 id="usage.fml"> <title> fml コマンドと makefml コマンド @@ -17,11 +18,11 @@ fml (/usr/local/bin/fml) <para> fml コマンドでは <screen> -% fml ＭＬ名 コマンド [コマンドのオプション] +% fml ＭＬ名 コマンド [コマンド固有のオプション] </screen> となります。一方、makefml では <screen> -% makefml コマンド ＭＬ名 [コマンドのオプション] +% makefml コマンド ＭＬ名 [コマンド固有のオプション] </screen> です。 各コマンドの使い方については makefml を参照して下さい。 diff --git a/fml/doc/ja/tutorial/usage/fmladdr.sgml b/fml/doc/ja/tutorial/usage/fmladdr.sgml index 33475ea3..98149b7f 100644 --- a/fml/doc/ja/tutorial/usage/fmladdr.sgml +++ b/fml/doc/ja/tutorial/usage/fmladdr.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fmladdr.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $ + $FML: fmladdr.sgml,v 1.2 2004/04/07 11:07:13 fukachan Exp $ --> + <sect1 id="usage.fmladdr"> <title> アドレス一覧を表示する (fmladdr コマンド) diff --git a/fml/doc/ja/tutorial/usage/fmlalias.sgml b/fml/doc/ja/tutorial/usage/fmlalias.sgml index e8bb32b3..304ed3af 100644 --- a/fml/doc/ja/tutorial/usage/fmlalias.sgml +++ b/fml/doc/ja/tutorial/usage/fmlalias.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fmlalias.sgml,v 1.1 2002/11/09 14:16:19 fukachan Exp $ + $FML: fmlalias.sgml,v 1.2 2004/04/07 11:07:13 fukachan Exp $ --> + <sect1 id="usage.fmlalias"> <title> エイリアスの一覧を表示する (fmlalias コマンド) diff --git a/fml/doc/ja/tutorial/usage/fmlconf.sgml b/fml/doc/ja/tutorial/usage/fmlconf.sgml index c8f7e318..17187b19 100644 --- a/fml/doc/ja/tutorial/usage/fmlconf.sgml +++ b/fml/doc/ja/tutorial/usage/fmlconf.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fmlconf.sgml,v 1.3 2002/07/07 01:57:12 fukachan Exp $ + $FML: fmlconf.sgml,v 1.4 2002/07/28 06:26:58 fukachan Exp $ --> + <sect1 id="usage.fmlconf"> <title> 設定を表示する (fmlconf コマンド) @@ -18,7 +19,7 @@ fmlconf (/usr/local/bin/fmlconf) <screen> % fmlconf elena </screen> -デフォルト値と異なる変数を表示する。 +デフォルト値と異なる変数のみを表示する。 <screen> % fmlconf -n elena </screen> diff --git a/fml/doc/ja/tutorial/usage/fmldoc.sgml b/fml/doc/ja/tutorial/usage/fmldoc.sgml index a072b11f..9f15d7cb 100644 --- a/fml/doc/ja/tutorial/usage/fmldoc.sgml +++ b/fml/doc/ja/tutorial/usage/fmldoc.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fmldoc.sgml,v 1.2 2002/07/07 01:57:12 fukachan Exp $ + $FML: fmldoc.sgml,v 1.3 2002/07/28 06:26:58 fukachan Exp $ --> + <sect1 id="usage.fmldoc"> <title> モジュールのドキュメントを表示する (fmldoc コマンド) diff --git a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml index 03c7b920..7675def0 100644 --- a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml +++ b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml @@ -1,7 +1,8 @@ <!-- - $FML: fmlhtmlify.sgml,v 1.5 2002/09/28 12:45:21 fukachan Exp $ + $FML: fmlhtmlify.sgml,v 1.6 2002/11/26 11:16:38 fukachan Exp $ --> + <sect1 id="usage.fmlhtmlify"> <title> 記事を HTML 化する (fmlhtmlify コマンド) diff --git a/fml/doc/ja/tutorial/usage/get.sgml b/fml/doc/ja/tutorial/usage/get.sgml index bc3a3c7b..54f21a06 100644 --- a/fml/doc/ja/tutorial/usage/get.sgml +++ b/fml/doc/ja/tutorial/usage/get.sgml @@ -1,7 +1,8 @@ <!-- - $FML: get.sgml,v 1.1 2002/07/28 12:20:19 fukachan Exp $ + $FML: get.sgml,v 1.2 2003/04/15 14:51:46 fukachan Exp $ --> + <sect1 id="usage.user.get"> <title> 過去の記事を読む @@ -15,7 +16,20 @@ get 記事番号 </screen> と書いたメールを elena-ctl@fml.org に送って下さい。 -記事が mime/multipart で送り返されます。 +要求した記事(群)は一つの mime/multipart で送り返されます。 +</para> + +<para> +気時番号の部分では MH 準拠の書き方をして構いません。 +<screen> +例 + +get 100 +get 1-100 +get first:3 +get last:3 +get 1-100,first:3,last:3 +</screen> </para> </sect1> diff --git a/fml/doc/ja/tutorial/usage/guide.sgml b/fml/doc/ja/tutorial/usage/guide.sgml index a06672ea..0b387ddd 100644 --- a/fml/doc/ja/tutorial/usage/guide.sgml +++ b/fml/doc/ja/tutorial/usage/guide.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: guide.sgml,v 1.1 2002/07/28 12:20:20 fukachan Exp $ --> + <sect1 id="usage.user.guide"> <title> ガイドを取り寄せる @@ -14,4 +15,10 @@ elena-ctl@fml.org に送って下さい。 ガイドが返送されます。 </para> +<para> +guide という名前のファイルがＭＬのホームディレクトリにあれば、そのファ +イルを送り返します。ない場合（デフォルト）は、テンプレートの guide ファ +イルがお繰り返されます。 +</para> + </sect1> diff --git a/fml/doc/ja/tutorial/usage/help.sgml b/fml/doc/ja/tutorial/usage/help.sgml index 8cb198a1..1eca106b 100644 --- a/fml/doc/ja/tutorial/usage/help.sgml +++ b/fml/doc/ja/tutorial/usage/help.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: help.sgml,v 1.1 2002/07/28 12:20:20 fukachan Exp $ --> + <sect1 id="usage.user.help"> <title> ＭＬのヘルプ: ＭＬの使い方を知りたい @@ -18,4 +19,10 @@ elena-ctl@fml.org に送って下さい。 ヘルプが送り返されます。 </para> +<para> +help という名前のファイルがＭＬのホームディレクトリにあれば、そのファ +イルを送り返します。ない場合（デフォルト）は、テンプレートの help ファ +イルがお繰り返されます。 +</para> + </sect1> diff --git a/fml/doc/ja/tutorial/usage/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml index ded99f97..f204dff7 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.7 2003/04/15 14:51:46 fukachan Exp $ + $FML: makefml.sgml,v 1.8 2004/04/07 11:07:13 fukachan Exp $ --> @@ -14,7 +14,7 @@ % makefml newml ＭＬ名 </screen> ＭＬ名は＠抜きの場合、デフォルトのドメインとなり、アドレスを完全に指定 -すればバーチャルドメインまで含めてmakefml がよろしくがんばることになっ +すればバーチャルドメインまで含めて makefml がよろしくがんばることになっ ています。もちろんデフォルトかバーチャルかにかかわらず、常に＠ドメイン つきで指定して構いません。例えば <screen> @@ -240,6 +240,7 @@ config.cf などをエディタで編集して下さい。 <warning> <para> makefml を使える管理者が一番偉い人です。当然:-)、 +makefml を使える管理者は、 (より権限の弱い)リモート管理のための諸設定をすることができます。 </para> </warning> diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml index 13250e5a..4147d320 100644 --- a/fml/doc/ja/tutorial/usage/post.sgml +++ b/fml/doc/ja/tutorial/usage/post.sgml @@ -1,7 +1,8 @@ <!-- - $FML: post.sgml,v 1.7 2003/04/15 14:51:46 fukachan Exp $ + $FML: post.sgml,v 1.8 2004/04/07 11:07:13 fukachan Exp $ --> + <sect1 id="usage.post"> <title> 記事の投稿 (配送処理プログラムについて) @@ -13,7 +14,7 @@ fml.org の elena ＭＬへの投稿は、 メールは MTA が受け、最終的に MTA は /usr/local/libexec/fml/distribute というコマンドを実行します。 -fml.pl はメールを標準入力から受けとり、 +distribute はメールを標準入力から受けとり、 ＭＬとして必要な処理(記事の保存やヘッダの書き換え)をした後、 MTA へ配送処理を委ねます。 </para> @@ -70,7 +71,9 @@ XXX-TODO 投稿記事の振舞いを制御する変数 <sect2> - <title> 解説: ブートしていく様子 </title> + <title> + 解説: ブートしていく様子 + </title> <para> <link linkend="bootloader"> @@ -81,9 +84,12 @@ fml ブートローダ <para> -/usr/local/libexec/loader は /usr/local/etc/fml/main.cf を読みこみます。 -fml_version 変数から使うべきライブラリのバージョンを決めます。例えば -fml_vesrion が current-20010501 となっていたら +/usr/local/libexec/fml/distribute と/usr/local/libexec/fml/loader は +symlink(2) で結ばれ、同一のファイルです。 +/usr/local/libexec/fml/distribute が起動されると、つまり loader が起動 +されると、/usr/local/libexec/fml/loader は /usr/local/etc/fml/main.cf +を読みこみます。そして fml_version 変数から使うべきライブラリのバージョ +ンを決めます。例えば fml_vesrion が current-20010501 となっていたら /usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといっ た具合です。 </para> diff --git a/fml/doc/ja/tutorial/usage/subscribe.sgml b/fml/doc/ja/tutorial/usage/subscribe.sgml index 9b48ca1c..825580c8 100644 --- a/fml/doc/ja/tutorial/usage/subscribe.sgml +++ b/fml/doc/ja/tutorial/usage/subscribe.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: subscribe.sgml,v 1.1 2002/07/28 12:20:20 fukachan Exp $ --> + <sect1 id="usage.user.subscribe"> <title> ＭＬに参加する diff --git a/fml/doc/ja/tutorial/usage/unsubscribe.sgml b/fml/doc/ja/tutorial/usage/unsubscribe.sgml index 17208899..afb54bb3 100644 --- a/fml/doc/ja/tutorial/usage/unsubscribe.sgml +++ b/fml/doc/ja/tutorial/usage/unsubscribe.sgml @@ -1,7 +1,8 @@ <!-- - $FML$ + $FML: unsubscribe.sgml,v 1.1 2002/07/28 12:20:20 fukachan Exp $ --> + <sect1 id="usage.user.unsubscribe"> <title> ＭＬを辞める diff --git a/fml/doc/ja/tutorial/virtual/chapter.sgml b/fml/doc/ja/tutorial/virtual/chapter.sgml index ffc7691e..e25ed801 100644 --- a/fml/doc/ja/tutorial/virtual/chapter.sgml +++ b/fml/doc/ja/tutorial/virtual/chapter.sgml @@ -1,7 +1,8 @@ <!-- - $FML: chapter.sgml,v 1.3 2003/11/24 04:44:58 fukachan Exp $ + $FML: chapter.sgml,v 1.4 2004/04/07 11:07:14 fukachan Exp $ --> + <chapter id="virtualdomain"> <title> バーチャルドメインの取り扱いについて @@ -57,7 +58,7 @@ rmdomain コマンドが創設されました。 <link linkend="install.virtual"> ml_home_prefix_maps </link> -を適宜、編集してくれます。 +(正確には primary_ml_home_prefix_map)を適宜、編集してくれます。 </para> <para> @@ -96,8 +97,12 @@ http://lists/~fml/cgi-bin/fml/$domain/admin/config.cgi <para> なお、CGI の URL にドメイン名が入っているのは、操作する人にとって分か りやすいようにという配慮であって、URL を元にドメイン名を決めているわけ -ではありません。ＭＬ名やドメイン名は newml 時に作成される .cgi スクリ -プトにハードコーディングされています。 +ではありません(それは危険です)。 +</para> + +<para> +ＭＬ名やドメイン名は newml 時に作成される .cgi スクリプトにハードコー +ディングされています。 </para> </warning> @@ -143,8 +148,11 @@ http://lists/~fml/cgi-bin/fml/$domain/admin/config.cgi </para> <para> -4.0 から 8.0 へは？ -一応、fml.pl は互換性のため fml.pl $DIR でも可で、 +4.0 から 8.0 へは？ mergeml コマンドがある。 +</para> + +<para> +一応、fml.pl は互換性のため fml.pl $DIR も可で、 libexec/distribute libexec/command など新しいコマンドは ＭＬ名を引数にとるということにしてある。 </para> |