diff options
Diffstat (limited to 'fml/doc/ja/tutorial/internals')
21 files changed, 145 insertions, 90 deletions
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> ユーザの登録、削除について |