diff options
| author | fukachan <fukachan> | 2005-06-25 15:11:27 +0000 |
|---|---|---|
| committer | fukachan <fukachan> | 2005-06-25 15:11:27 +0000 |
| commit | fac8b3742dafc474f18fdfce7725a6b37698d61c (patch) | |
| tree | d4f487cceecec46c65fd65e889b09692857e96b9 /fml/doc/ja/tutorial/internals | |
| parent | 84d1b40a0d4f5efb5718d25be69e4aa274c5cb0e (diff) | |
| download | fml8-fac8b3742dafc474f18fdfce7725a6b37698d61c.tar.gz fml8-fac8b3742dafc474f18fdfce7725a6b37698d61c.tar.bz2 fml8-fac8b3742dafc474f18fdfce7725a6b37698d61c.zip | |
clean up / fixed.
Diffstat (limited to 'fml/doc/ja/tutorial/internals')
| -rw-r--r-- | fml/doc/ja/tutorial/internals/bootloader.sgml | 40 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/cgi.examples.sgml | 10 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/cgi.sgml | 4 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/config.cf.sgml | 11 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/db_modules.sgml | 86 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/dbms.sgml | 30 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/directory.sgml | 4 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/filter.sgml | 18 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/io_abstraction.sgml | 10 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/lock.sgml | 9 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/merge.sgml | 8 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/restriction.sgml | 35 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/internals/style.sgml | 4 |
13 files changed, 116 insertions, 153 deletions
diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml index dd9a61e8..823261b6 100644 --- a/fml/doc/ja/tutorial/internals/bootloader.sgml +++ b/fml/doc/ja/tutorial/internals/bootloader.sgml @@ -1,5 +1,5 @@ <!-- - $FML: bootloader.sgml,v 1.11 2004/04/07 11:07:06 fukachan Exp $ + $FML: bootloader.sgml,v 1.12 2004/10/06 09:07:37 fukachan Exp $ --> @@ -45,19 +45,19 @@ loader から次々と呼ばれていく様子は、例えば配送処理の場合、次のよう </para> <para> -libexec/loader は /usr/local/etc/fml/main.cf を読みこみ、 -fml_version 変数から使うべきライブラリのバージョンを決めます。 -例えば fml_vesrion が current-20010501 となっていたら -/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといった -具合です。 +/usr/local/libexec/fml/distributre (の実体は +/usr/local/libexec/fml/loader) は /usr/local/etc/fml/main.cf を読みこ +み、fml_version 変数から使うべきライブラリのバージョンを決めます。例え +ば fml_vesrion が current-20010501 となっていたら +/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといっ +た具合です。 </para> <para> -@INC を設定した後、 +@INC を再設定した後、 loader は FML::Process::Switch をロードし、 $0 を調べます。 -その名前から自分の仕事は配送処理だと知ります。 -配送処理なので +その名前から自分の仕事は配送処理配送処理なので FML::Process::Distribute クラスをロードし、配送処理に移ります。 </para> @@ -68,11 +68,10 @@ etc/fml/defaults/バージョン/modules </para> <para> -こういった処理は見かけ上 -FML::Process::Flow::ProcessStart() という関数が制御しています。 -ProcessStart() が引数として -FML::Process::Distribute を渡され、 -FML::Process::Distribute を実行していくという流れになります。 +こういった処理は見かけ上 FML::Process::Flow::ProcessStart() という関数 +が制御しています。ProcessStart() が引数として FML::Process::Distribute +オブジェクトを渡され、FML::Process::Distribute オブジェクトを実行して +いくという流れになります。 </para> </sect1> @@ -110,7 +109,7 @@ FML::Process::Mead >-| | libexec/loader (wrapper) Bootstrap() を実行する。 libexec/distribute などは、皆この loader へのシンボリックリンクです。 - /usr/local/libexec/fml/ を参照して下さい。 + /usr/local/libexec/fml/ 以下を参照して下さい。 </para> </listitem> @@ -121,8 +120,9 @@ FML::Process::Mead >-| | /usr/local/etc/fml/main.cf を読み込む。 読み込むと fml のバージョンが分かる。 main.cf の値から @INC を再設定しバージョン依存性を解決します。 - default_config.cf はバージョン依存であるので、 - ここでまずバージョンを評価しなければいけないことに注意してください。 + default_config.cf はバージョン依存ですので、 + 設定ファイルを読み込む前に、 + この段階でバージョンを評価しなければいけないことに注意してください。 </para> </listitem> @@ -146,7 +146,7 @@ FML::Process::Mead >-| | <para> Bootstrap2() および ProcessSwitch() を実行し、 配送用、コマンドメール用の各プロセスへ - 制御を移します(分岐する)。 + 制御を移します。 この時は $0 から自分の名前を知り、 どのプロセスへ分岐すればいいのかを判断しています。 </para> @@ -160,7 +160,7 @@ FML::Process::Mead >-| | そして、プロセスをスタートさせます。 FML::Process::Flow の中に、 - どのように fml プロセスを実行するかが + どのように fml8 プロセスを実行するかが 定義されています。大雑把には <screen> $process = new FML::Process::なにか; @@ -216,7 +216,7 @@ ProcessSwitch() hints を渡す?使う? (CGI のみ?) -ProcessStart($obj,$args) +ProcessStart($obj, $args) 処理本体のスタート diff --git a/fml/doc/ja/tutorial/internals/cgi.examples.sgml b/fml/doc/ja/tutorial/internals/cgi.examples.sgml index bb720ff3..ea2987aa 100644 --- a/fml/doc/ja/tutorial/internals/cgi.examples.sgml +++ b/fml/doc/ja/tutorial/internals/cgi.examples.sgml @@ -1,5 +1,5 @@ <!-- - $FML: cgi.examples.sgml,v 1.1 2004/03/31 06:03:00 fukachan Exp $ + $FML: cgi.examples.sgml,v 1.2 2004/10/06 09:07:37 fukachan Exp $ 注意: cgi.sgml の中にはめ込むので <chapter> は不必要だ。 --> @@ -22,13 +22,13 @@ FML::CGI::Thread FML::Process::CGI::Kernel FML::Process::CGI::Param </para> <para> -各 .cgi 固有のコードは FML::CGI:: の階層に置くようにします。 +各 .cgi 固有のコードは FML::CGI:: の階層に置くようにしています。 </para> <para> FML::Process::CGI::Kernel には、 プロセス全体の制御部分と、 -デフォルトの CGI 固有関数 run_cgi_なんとか() を置きます。 +デフォルトの CGI 固有の関数「run_cgi_なんとか()」を置きます。 必要に応じて FML::CGI:: の階層でオーバーロードしてください。 なお、FML::Process::CGI::Kernel の以下のメソッドは使われていません。 <screen> @@ -75,13 +75,13 @@ FML::Process::CGI::Kernel では $curproc->_drive_cgi_by_table(); (FML::Process::CGI::Kernel) $curproc->html_end(); (FML::CGI::Menu) </screen> -を実行します。画面を作るのは _drive_cgi_by_table() です。 +を実行します。画面を作るのは _drive_cgi_by_table() の部分です。 この関数から呼ばれる関数が CGI のメイン部分です。 </para> <para> $curproc->_drive_cgi_by_table() -は、以下の各「run_いろいろ()」メソッドを呼び出します。 +は、以下の各「run_いろいろ()」メソッド群を呼び出します。 <screen> run_cgi_main (FML::CGI::Menu) </screen> diff --git a/fml/doc/ja/tutorial/internals/cgi.sgml b/fml/doc/ja/tutorial/internals/cgi.sgml index f40909b7..f153a420 100644 --- a/fml/doc/ja/tutorial/internals/cgi.sgml +++ b/fml/doc/ja/tutorial/internals/cgi.sgml @@ -1,5 +1,5 @@ <!-- - $FML: cgi.sgml,v 1.12 2004/03/31 06:03:01 fukachan Exp $ + $FML: cgi.sgml,v 1.13 2004/10/06 09:07:38 fukachan Exp $ --> @@ -77,7 +77,7 @@ fml CGI スクリプトでは典型的な画面が次のように分割されると考えています。 </para> <para> -ヘッダ部分( HTTP ヘッダではなく、HTML の DOCTYPE から BODY あたり)やフッ +ヘッダ部分(HTTP ヘッダではなく、HTML の DOCTYPE から BODY あたり)やフッ タの部分は html_start() および html_end() で HTML コードを生成します。 </para> diff --git a/fml/doc/ja/tutorial/internals/config.cf.sgml b/fml/doc/ja/tutorial/internals/config.cf.sgml index a7693a8c..38ab08ac 100644 --- a/fml/doc/ja/tutorial/internals/config.cf.sgml +++ b/fml/doc/ja/tutorial/internals/config.cf.sgml @@ -1,5 +1,5 @@ <!-- - $FML: config.cf.sgml,v 1.12 2004/04/07 11:07:07 fukachan Exp $ + $FML: config.cf.sgml,v 1.13 2004/10/06 09:07:38 fukachan Exp $ --> @@ -27,7 +27,7 @@ </para> <para> -&fmldevel; では config.cf 一つです。 +一方 &fmldevel; では config.cf というファイルです。 フォーマットは postfix や .ini 風の <screen> 変数 = 値 @@ -190,8 +190,9 @@ x = a b c d e 『デフォルトの定義』、 『サイト固有の定義』、 『ドメイン固有の定義』 -などを別のファイルに分離することができます。 -デフォルトでは、いくつかの .cf ファイルに分離されています。 +などを別のファイルに分離し、上書きしつつ多重読み込みをすることができま +す。これをするため、デフォルトでは、いくつかの .cf ファイルに分離され +ています。 </para> <para> @@ -245,7 +246,7 @@ $config->{ another_key } get() はこのハッシュではなく %_fml_config_result の値を返しています。 このハッシュ中の値は $dir などが展開された後の値で、 /var/spool/ml/elena/file などとなっています。 -この変数の値の展開は get() なりで呼ばれた時に始めて行なわれます。 +この変数の値の展開は get() なりが呼ばれた際に始めて行なわれます。 </para> </sect2> diff --git a/fml/doc/ja/tutorial/internals/db_modules.sgml b/fml/doc/ja/tutorial/internals/db_modules.sgml index e1f02cf6..f262af5c 100644 --- a/fml/doc/ja/tutorial/internals/db_modules.sgml +++ b/fml/doc/ja/tutorial/internals/db_modules.sgml @@ -1,5 +1,5 @@ <!-- - $FML: db_modules.sgml,v 1.1 2003/05/31 08:51:09 fukachan Exp $ + $FML: db_modules.sgml,v 1.2 2004/10/06 09:07:38 fukachan Exp $ --> <!-- @@ -45,8 +45,14 @@ message-id のデータを持っていますし、記事の分については重複しています。 Mail::Message::DB </link> のようなものとし、各種アダプタ層が頑張って欲しい。 -また、キャッシュの方だが、現在では Tie::JournaledDir もしくは -File::CacheDir かのいづれかが使われることとなる。 +また、キャッシュの方ですが、現在では Tie::JournaledDir もしくは +FML::Cache::Ring のいづれかが使われることとなっています。 +</para> + +<para> +なお、メンバーリストなどの永続性の必要なデータに対するデータベースはき +ちんと DBMS (データベース管理システム)を使うべきです。ここで述べている +データベースは fml8 が動作する上で内部的に使っているデータベースです。 </para> </sect1> @@ -75,41 +81,15 @@ DBMS を使うべきでしょう。 </para> - <para> -そういったわけで &fml8; では、expire の仕方に応じて2つのデータ保持ク -ラスを用意しています。それは「サイズを気にせず、時間を区切って expire -するのか?」もしくは「使用する領域のサイズをある程度気にするか?」の2 -種類です。 +ここでは fml8 内部で使っているモジュールの話をします。 </para> -<warning> <para> -現在では -Tie::JournaledFile クラス -を利用した -Tie::JournaledDir クラス -もあるので、 -将来 -Tie::JournaledDir もしくは File::CacheDir かのいづれかは -不必要になるかも知れません。 -また、インターフェイスの違いから適宜使い分けるのかもしれません。 -</para> - -<para> -2002/08: -File::CacheDir は改名し、なくす方向で考えています。 -そもそも File::CacheDir は -FML/Process/Kernel.pm -と -FML/Filter/TrafficMonitor.pm -でしか使ってません。 -しかも、 -TrafficMonitor.pm は事実上未完成なので、まだ変更が可能です。 -実際 FML::Process::Kernel の var/mail/ でしか使っていないので、 -File::CacheDir を使わないようにすることが可能でしょう。 +&fml8; では、データの expire の仕方に応じて2つのデータ保持クラスを用 +意しています。それは「サイズを気にせず、時間を区切って expire するのか?」 +もしくは「使用する領域のサイズをある程度気にするか?」の2種類です。 </para> -</warning> </sect1> @@ -174,26 +154,25 @@ get_all_values_as_hash_ref() <warning> <para> -なお検索時の挙動の -first match と last match は切替えることができます。 -どちらの戦略で探すのか、 -クラスオブジェクトを生成する際に明示的に指定することが推奨されます。 -デフォルトは first match です。 +なお検索時の挙動のfirst match と last match は切替えることができます。 +どちらの戦略で探すのか、クラスオブジェクトを生成する際に明示的に指定す +ることが推奨されます。デフォルトは last match です(最後に書き込んだデー +タが返される振舞いが自然です)。 </para> </warning> </sect1> -<sect1 id="db.module.File.CacheDir"> +<sect1 id="db.module.FML.Cache.Ring"> <title> - File::CacheDir クラス + FML::Cache::Ring クラス </title> <para> この <ulink url="../../en/modules/File/CacheDir.txt"> - File::CacheDir + FML::Cache::Ring </ulink> クラスは、主にサイズに上限を設けたいタイプのデータを蓄える場合に用 います。expire の時間については気にしません。 @@ -202,7 +181,7 @@ first match と last match は切替えることができます。 <para> -デバッグ等に用いるデータはこれで十分と考えています。 +デバッグ等に用いるデータはこれで十分と考えます。 普段は使わないデバッグのために、サイズを食われるのも嫌ですから。 </para> @@ -218,31 +197,12 @@ first match と last match は切替えることができます。 <warning> <para> -旧 RingBuffer は File::CacheDir に統合されました。 +旧 RingBuffer は FML::Cache::Ring に統合されました。 +また、FML::Cache::Ring は File::CacheDir から作られました。 </para> </warning> </sect1> - -<sect1 id="db.module.usage"> - <title> - モジュールの使い分け - </title> - -<para> -う〜ん、困りましたね… -</para> - -<para> -元々はサイズの上限を重視する場合が -リングバッファ、つまり File::CacheDir でした。 -逆に、 -時間方向の expire を重視する場合は Tie::Journaled* を使うつもりでした。 -でも時間方向の File::CacheDir はそれと一緒じゃん;) -</para> - -</sect1> - </chapter> diff --git a/fml/doc/ja/tutorial/internals/dbms.sgml b/fml/doc/ja/tutorial/internals/dbms.sgml index b1a7257b..dfb627e0 100644 --- a/fml/doc/ja/tutorial/internals/dbms.sgml +++ b/fml/doc/ja/tutorial/internals/dbms.sgml @@ -1,5 +1,5 @@ <!-- - $FML: dbms.sgml,v 1.5 2003/05/31 08:51:09 fukachan Exp $ + $FML: dbms.sgml,v 1.6 2004/10/06 09:07:38 fukachan Exp $ --> @@ -8,6 +8,17 @@ データベース管理システム </title> +<para> +メンバーリストなどの永続性の必要なデータに対しデータベースを用いたいな +ら、きちんと DBMS (データベース管理システム)を使うべきです。ここで述べ +ているデータベースとは、そういった意味合いのデータを相手にしています。 +一方 fml8 が動作する上で内部的に使うデータベースモジュールについては +<link linkend="db.module"> +<xref linkend="db.module"> +</link> +を参照して下さい。 +</para> + <sect1 id="dbms.overview"> <title> @@ -31,21 +42,4 @@ IO::Adapter の前段階のプログラムが頑張る必要があります。 </sect1> -<sect1 id="dbms.todo"> - <title> - TODO - </title> - -<para> -メソッドが必要最少限になっているかは考えた方がいい。 -けれど、 -<link linkend="module.io.adapter"> -IO::Adapter -</link> -のメソッド準拠ではあるので、とりあえずいいのかな。 -</para> - -</sect1> - - </chapter> diff --git a/fml/doc/ja/tutorial/internals/directory.sgml b/fml/doc/ja/tutorial/internals/directory.sgml index 407bab82..bf3ed14e 100644 --- a/fml/doc/ja/tutorial/internals/directory.sgml +++ b/fml/doc/ja/tutorial/internals/directory.sgml @@ -1,5 +1,5 @@ <!-- - $FML: directory.sgml,v 1.4 2004/04/07 11:07:08 fukachan Exp $ + $FML: directory.sgml,v 1.5 2004/10/06 09:07:38 fukachan Exp $ --> @@ -28,7 +28,7 @@ <para> 現代の性能では、ディレクトリ中に 1000 くらいの構造なら、あってもほとん -ど瞬時に ls は返ってきますが、10000 ともなるとちょっと考えちゃう。 +ど瞬時に ls は返ってきますが、10000 ともなるとちょっと考えます。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/filter.sgml b/fml/doc/ja/tutorial/internals/filter.sgml index b01467a0..0117b0a5 100644 --- a/fml/doc/ja/tutorial/internals/filter.sgml +++ b/fml/doc/ja/tutorial/internals/filter.sgml @@ -1,5 +1,5 @@ <!-- - $FML: filter.sgml,v 1.7 2004/04/20 03:36:34 fukachan Exp $ + $FML: filter.sgml,v 1.8 2004/10/06 09:07:39 fukachan Exp $ --> @@ -161,9 +161,9 @@ text/html reject </para> <para> -MIME が前提なので、!MIME なんてのはないですが、text/plain と -multipart/mixed 中の text/plain を区別するために、こういう書き方である -必要があるとおもうわけです。 +MIME が前提なので、!MIME (MIME 以外を対象とする)という命令はありません +が、text/plain と multipart/mixed 中の text/plain を区別するために、こ +ういう書き方である必要があるとおもうわけです。 <screen> 全体 部分 アクション ---------------------------------------------- @@ -204,19 +204,19 @@ text/plain :size>500k cutoff </title> <para> -では、permit はどうでしょう?実のところ文脈依存と考えらますが、何が正 -しいのかよくわかりません。たとえば、multipart のメールの中身が +では、permit はどうでしょう?実のところ文脈依存と考えられますが、何が +正しいのかよくわかりません。たとえば、multipart のメールの中身が <screen> text/plain + image/jpeg + text/html </screen> のように3つの異なるタイプのパートからなる場合、どういうルールなら曖昧 -さがないのだろうか? +さがないでしょうか? </para> <para> 結論をいえば、cutoff や reject を指定するタイプのルールしかうまく機能 しない、つまり「特定の○○を削除ないしは拒否する」ことならうまくできる -といえそうです。ゆえにデフォルトは permit にするしかない。 +といえそうです。ゆえにデフォルトは permit にするしかありません。 </para> <para> @@ -244,7 +244,7 @@ text/plain * permit </screen> と一緒になってしまうわけです。だから permit は"メール全体を OK として ルールとの照らし合わせ処理をそこで終りにする"という意味にしないといけ -ない。よって、次のようなルールはありえない。 +ません。よって、次のようなルールはありえないことになります。 <screen> text/plain * permit multipart/mixed text/plain permit diff --git a/fml/doc/ja/tutorial/internals/io_abstraction.sgml b/fml/doc/ja/tutorial/internals/io_abstraction.sgml index 0aa6841b..12ccb233 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.3 2003/05/27 10:59:27 fukachan Exp $ + $FML: io_abstraction.sgml,v 1.4 2004/10/06 09:07:39 fukachan Exp $ --> @@ -226,8 +226,8 @@ while ($obj->get_next_key()) { ... } </para> <para> -これはハッシュの FIRST_KEY() と NEXT_KEY() にあたるといえます。でも、 -我々の場合は open() などのメソッドが別途用意されているため、 +これはハッシュの FIRST_KEY() と NEXT_KEY() にあたるといえます。 +しかしながら、我々の場合は open() などのメソッドが別途用意されているため、 FIRST_KEY() と NEXT_KEY() のように2つに分ける必要はありません。 </para> @@ -268,7 +268,7 @@ PRIMARY KEY の一覧くらいか? 定石は全部読んでみること、つまり get_next_key() を呼びまくるコードです。 専用のメソッドがあった方が便利でしょうけど、 滅多にそんなコードは必要ないようなので、 -専用メソッドがなくても問題はがないようです。 +専用メソッドがなくても問題はないようです。 </para> <para> @@ -291,7 +291,7 @@ ARRAY_REF で返すのでしょうかね?でも、find('*', { all => 1 }) などとす <para> これこそ、どういうデータ構造が欲しいんでしょうねぇ? -返り値が HASH_REF であるようなメソッドが欲しいだろうか? +返り値が HASH_REF であるようなメソッドが欲しいのだろうか? <screen> 返り値 = { 変数1 => 値1、 diff --git a/fml/doc/ja/tutorial/internals/lock.sgml b/fml/doc/ja/tutorial/internals/lock.sgml index a07d44a3..f02d3baf 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.3 2003/04/15 14:51:41 fukachan Exp $ + $FML: lock.sgml,v 1.4 2004/10/06 09:07:39 fukachan Exp $ --> @@ -8,6 +8,11 @@ ロック </title> +<para> +プロセス間の同期化はロックを用いて行ないます。fml8 でサポートされてい +るロックメカニズムは flock(2) or lockf(2) を元にしたロック機構のみです。 +</para> + <sect1 id="lock.overview"> <title> @@ -65,7 +70,7 @@ FML/Credential.pm </title> <para> -*_maps をよぶまえには MUTEX ロックをする。いや、やりすぎかもしれません。 +*_maps をよぶまえには MUTEX でロックをする。いや、やりすぎかもしれません。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/merge.sgml b/fml/doc/ja/tutorial/internals/merge.sgml index 9364fb68..b8059e1f 100644 --- a/fml/doc/ja/tutorial/internals/merge.sgml +++ b/fml/doc/ja/tutorial/internals/merge.sgml @@ -1,5 +1,5 @@ <!-- - $FML: merge.sgml,v 1.1 2004/03/23 05:16:52 fukachan Exp $ + $FML: merge.sgml,v 1.2 2004/10/06 09:07:40 fukachan Exp $ --> @@ -24,9 +24,9 @@ </para> <para> -1) fml-devel をインストールする。この際、postfix の alias_maps に -/var/spool/ml/etc/mail/aliases (まだ、この段階では中身のないファイル) -を追加する。 +1) fml8 をインストールする。この際、postfix の alias_maps に +/var/spool/ml/etc/mail/aliases (まだ、この段階では中身のないファイルで +よい)を追加する。 </para> <para> diff --git a/fml/doc/ja/tutorial/internals/restriction.sgml b/fml/doc/ja/tutorial/internals/restriction.sgml index f53f5088..bcb0c597 100644 --- a/fml/doc/ja/tutorial/internals/restriction.sgml +++ b/fml/doc/ja/tutorial/internals/restriction.sgml @@ -1,5 +1,5 @@ <!-- - $FML: restriction.sgml,v 1.7 2003/04/15 14:51:41 fukachan Exp $ + $FML: restriction.sgml,v 1.8 2004/10/06 09:07:40 fukachan Exp $ --> @@ -25,13 +25,15 @@ </title> <para> -FML::Restriction クラスによる入力データチェックはありませんが、 -FML::Filter クラスによるフィルタチェックがデフォルトで適用されます。フィ -ルタをはずすには、config.cf で -<screen> -use_article_body_filter = no -</screen> -を設定して下さい。 +そもそも記事に対する入力制限(入力データの表現範囲の制限)というものは考 +えにくいです。実際 FML::Restriction クラスによる入力データチェックはあ +りません。 +</para> + +<para> +(FML::Restriction の対象としている操作とは意味合いが異なりますが)一行 +メールなどをはじくために FML::Filter クラスによるフィルタチェックがデ +フォルトで適用されています。 </para> </sect2> @@ -45,7 +47,7 @@ use_article_body_filter = no <para> コマンドメールは FML::Process::Command の中で一行ずつ FML::Restriction::Command で定義されている正規表現にしたがって -検査されます。検査に合格すれば、 +入浴されたコマンド列が検査されます。検査に合格すれば、 FML::Command::{User,Admin}::コマンド の実行に進むことができます。 </para> @@ -58,8 +60,8 @@ FML::Command::{User,Admin}::コマンド の実行に進むことができます。 </title> <para> -CGI の各プログラムでは、safe_param_ほえほえ() という関数経由でのみデー -タを受けとることができます。 +CGI の各プログラムでは、safe_param_XXX() という関数経由でのみ HTTP セッ +ションからのデータを受けとることができます。 </para> <para> @@ -71,7 +73,8 @@ try_cgi_*() <para> これらの safe_param_XXX() は FML::Restriction::CGI ( -FML::Restriction::Base を継承している)経由でパターンの検査をしています。 +FML::Restriction::Base を継承している)経由でパターンの検査をし、 +検査に合格した場合にのみ値が返されています。 </para> </sect2> @@ -83,9 +86,9 @@ FML::Restriction::Base を継承している)経由でパターンの検査をしています。 </title> <para> -コマンドラインで実行するので、「入力チェックなし」がデフォルトです。 -そのシェルが取れる時点で認証されているはずなので、 -正しいユーザ/そのユーザのすることは正しいと信じています。 +コマンドラインで実行するので「入力チェックなし」がデフォルトです。つま +り、そのシェルが取れる時点で正規のユーザであると認証されているはずなの +で「正しいユーザ/そのユーザのすることはすべて正しい」と信じています。 </para> <para> @@ -179,7 +182,7 @@ for my $key (param()) { <sect1> <title> - 議論; FML::Restriction の制限はきびし過ぎる? + 議論: FML::Restriction の制限はきびし過ぎる? </title> <para> diff --git a/fml/doc/ja/tutorial/internals/style.sgml b/fml/doc/ja/tutorial/internals/style.sgml index d57af393..b499b393 100644 --- a/fml/doc/ja/tutorial/internals/style.sgml +++ b/fml/doc/ja/tutorial/internals/style.sgml @@ -1,5 +1,5 @@ <!-- - $FML: style.sgml,v 1.12 2004/04/07 11:07:08 fukachan Exp $ + $FML: style.sgml,v 1.13 2004/10/06 09:07:40 fukachan Exp $ --> @@ -275,7 +275,7 @@ Srting::is_japanese_string() <para> Perl ではポリモーフィズムと実行時バインディングができることに - は重視すること。多重継承などに頭を使うより + 重視すること。多重継承などに頭を使うより ポリモーフィズムと実行時バインディングによる コンポーネント指向ぽい方向性を模索する。 </para> |
