From 30d3f7d6a197e596d3aba689c73073198293d5c3 Mon Sep 17 00:00:00 2001 From: fukachan Date: Thu, 10 May 2001 03:11:43 +0000 Subject: clean up Japanese resolve some warning by openjade e.g. tags in table entries --- fml/doc/ja/tutorial/internals/bootloader.sgml | 49 ++++++++++++++-------- fml/doc/ja/tutorial/internals/config.cf.sgml | 29 +++++++++---- fml/doc/ja/tutorial/internals/design.sgml | 59 ++++----------------------- fml/doc/ja/tutorial/internals/main.cf.sgml | 10 ++++- 4 files changed, 73 insertions(+), 74 deletions(-) (limited to 'fml/doc/ja/tutorial/internals') diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml index 9d5e10b0..7c12e857 100644 --- a/fml/doc/ja/tutorial/internals/bootloader.sgml +++ b/fml/doc/ja/tutorial/internals/bootloader.sgml @@ -1,5 +1,5 @@ @@ -11,41 +11,58 @@ fml 5.0 にはインストールされている fml のバージョン依存性を考慮するた めに、実行時には本章で述べるようなブートストラップの過程があります。 - + boot していくイメージ libexec/loader -> FML::Process::Switch -> FML::Process::Flow -> FML::Process::それぞれのプログラムのモジュール - + - 例: 配送の場合 + 例: 配送の場合 loader から次々と呼ばれていく様子は、例えば配送処理の場合、次のよう -になる。 +になります。 + + + +libexec/loader は /etc/fml/main.cf を読みこみます。 +fml_version 変数から使うべきライブラリのバージョンを決めます。 +例えば fml_vesrion が current-20010501 となっていたら +/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといった +具合です。 + - -libexec/loader は FML::Process::Switch をロードし、 -FML::Process::Distribute を実行すると決める。 + +@INC を設定した後、 +loader は FML::Process::Switch をロードし、 +$0 を調べます。 +その名前から自分の仕事は配送処理だと知ります。 +配送処理なので +FML::Process::Distribute をロードし、配送処理に移ります。 + -FML::Process::Flow::ProcessStart() は引数として + +こういった処理は見かけ上 +FML::Process::Flow::ProcessStart() という関数が制御しています。 +ProcessStart() が引数として FML::Process::Distribute を渡され、 -FML::Process::Distribute を実行していく。 - +FML::Process::Distribute を実行していくという流れになります。 + - FML::Process:: クラスの階層構造 + FML::Process:: クラスの階層構造 - + FML::Process::Distribute >-| FML::Process::Command >-|-- FML::Process::Kernel FML::Process::Mead >-| | @@ -53,7 +70,7 @@ FML::Process::Mead >-| | |-use-a FML::Config |-use-a FML::Log |-use-a ... その他 ... - + => @@ -132,12 +149,12 @@ FML::Process:: FML::Process::Flow の中に、 どのように fml プロセスを実行するかが 定義されています。 - + $process = new FML::Process::なにか; $process->prepare($args); $process->run($args); $process->finish($args); - + のように実行されています。 各プロセスは、それぞれについて適当な関数を 用意してください。 diff --git a/fml/doc/ja/tutorial/internals/config.cf.sgml b/fml/doc/ja/tutorial/internals/config.cf.sgml index ca16a24e..c08b209b 100644 --- a/fml/doc/ja/tutorial/internals/config.cf.sgml +++ b/fml/doc/ja/tutorial/internals/config.cf.sgml @@ -1,5 +1,5 @@ @@ -12,15 +12,19 @@ 各ＭＬごとにさまざまなカスタマイズをすることができます。 +この点は &fml4; でも &fml5; でも同様です。 + + + そのために &fml4; では 各ＭＬのホームディレクトリ $DIR に config.ph というファイルがあります。 これは .ph という名前でわかる通り perl script です。 -perl script にはいくつか問題があります。 -perl script なので、perl が許す限りの自由な書き方ができます。 -これが config.ph の最大の問題です。 +この perl script 方式にはいくつか問題があります。 +例えば perl script なので、perl が許す限りの自由な書き方ができます。 +これは config.ph の最大の問題です。 makefml や CGI をはじめとする設定インターフェイスを書きにくいのです。 @@ -31,11 +35,12 @@ cf -しかし、これはこれで２つにわかれていることから保守しにくいものです。 +しかし、これはこれで２つのファイルに分かれてしまう点が +保守しにくさを生みます。 よって &fml5; では、設定インターフェイスにやさしい 新フォーマットを提唱します。 それが config.cf です。 -これは本質的に postfix 風のフォーマットといってよいでしょう。 +これは本質的に postfix 風のフォーマットです。 @@ -112,6 +117,10 @@ b = 『サイト固有の定義』、 『ドメイン固有の定義』 などを別のファイルに分離することができます。 +デフォルトでは分離されています。 + + + fml は起動時にそれらのファイルを順番に読みこみ、 最後にＭＬ固有の config.cf を読み込みます。 そして、その後に変数の展開処理を行ないます。 @@ -125,7 +134,13 @@ fml $ をふくむ変数の値の代入が行なわれると、 -次回値を取り出すメソッドが呼ばれた際に、再展開が行なわれます。 +次に値を取り出すメソッド + + + perl の tie 操作 + + +が呼ばれた際に、変数の再展開が行なわれます。 diff --git a/fml/doc/ja/tutorial/internals/design.sgml b/fml/doc/ja/tutorial/internals/design.sgml index efafd6ca..73523b64 100644 --- a/fml/doc/ja/tutorial/internals/design.sgml +++ b/fml/doc/ja/tutorial/internals/design.sgml @@ -1,5 +1,5 @@ @@ -251,33 +251,12 @@ fml - 設定ファイル形式 - - - - cf と config.ph を統合化する - - - - - - 配列を表現できる形式 - - - - - - メニュープログラムが楽できるフォーマットを - - - - - - 原則として”設定ファイル”という名のものは - どれも同じフォーマットとする。 - - - + 設定ファイルの形式は + cf と config.ph を統合化したようなもので、 + 配列を表現できる形式とする。 + メニュープログラムが楽できるフォーマットにしたい。 + 原則として”設定ファイル”という名のものは + どれも同じフォーマットとする。 @@ -286,27 +265,7 @@ fml - 変数の命名規則 - - - - USE_機能 - - - - - - 機能_TYPE - - - - - - 機能_ATTRIBUTES - - - - + 変数の命名規則の規格化 ”USE_ほえ”および”ほえ_TYPE”形式か？ @@ -383,7 +342,7 @@ fml アーキテクチャア・イメージ - + diff --git a/fml/doc/ja/tutorial/internals/main.cf.sgml b/fml/doc/ja/tutorial/internals/main.cf.sgml index 55e37fe1..c8ffd103 100644 --- a/fml/doc/ja/tutorial/internals/main.cf.sgml +++ b/fml/doc/ja/tutorial/internals/main.cf.sgml @@ -1,5 +1,5 @@ /etc/fml/main.cf @@ -12,6 +12,14 @@ fml +main.cf はこのようなファイルです。 + +フォーマットは + +変数名 = 値 + +です。 + # fml version # This is important -- cgit v1.2.1