merge 01_* with tutorial/

2 files changed, 120 insertions, 13 deletions

diff --git a/fml/doc/ja/tutorial/internals/bootloader.sgml b/fml/doc/ja/tutorial/internals/bootloader.sgml
index 56fe2d9d..f436e301 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.7 2002/07/02 10:39:35 fukachan Exp $
+   $FML: bootloader.sgml,v 1.8 2002/07/06 14:55:18 fukachan Exp $
 -->
 
 <chapter id="bootloader">
@@ -13,18 +13,32 @@
 めに、本章で述べるようなブートストラップの過程があります。
 
 <screen>
-fml が boot していくイメージ
-
-libexec/loader ->
-     FML::Process::Switch ->
-         FML::Process::Flow ->
-              FML::Process::それぞれのプログラムのモジュール
+fml (libexec/distribute) が boot していくイメージ
+
+       functions                class
+       ----------------------------------------
+
+       main::Bootstrap()        libexec/loader
+            |
+            V
+       main::Bootstrap2()       FML::Process::Switch
+            |
+            V
+       ProcessSwitch()          FML::Process::Switch
+            |
+            |
+            | switch to ($obj = FML::Process:Distribute)
+            |
+            V                   
+       ProcessStart($obj,$args) FML::Process::Flow
 </screen>
 </para>
 
 
-<sect1>
-   <title> 例: 配送の場合 </title>
+<sect1 id="bootloader.example.distribute">
+	<title>
+	例: 配送の場合
+	</title>
 
 <para>
 loader から次々と呼ばれていく様子は、例えば配送処理の場合、次のよう
@@ -59,8 +73,10 @@ FML::Process::Distribute を実行していくという流れになります。
 </sect1>
 
 
-<sect1>
-  <title> FML::Process:: クラスの階層構造 </title>
+<sect1 id="bootloader.classes">
+	<title>
+	FML::Process:: クラスの階層構造
+	</title>
 
 <para>
 <screen>
@@ -77,7 +93,7 @@ FML::Process::Mead       >-|    |
 </sect1>
 
 
-<sect1>
+<sect1 id="bootloader.classes2">
 	<title>
 	プロセス実行時に使われるモジュール群
 	</title>
@@ -167,4 +183,54 @@ $process->finish($args);
 </sect1>
 
 
+<sect1 id="bootloader.resolv.mlxxx">
+	<title>
+	ml_name と ml_domain の値はどこで解決するのが正しいか？
+	</title>
+
+<para>
+<screen>
+main::Bootstrap()
+
+	main.cf から fml のバージョン依存性を解く
+
+	hints を渡す (CGI のみ)	
+		◎ CGI だけ
+		嘘の入力がありうる
+		そのため、loader に hints として
+		ml_domain や ml_name がハードコードされている。 
+
+
+main::Bootstrap2()
+ProcessSwitch()
+
+	使うモジュール( Process::なんか )を決める
+		読み込むべき cf ファイルの決定（なんで？）
+		ライブラリパスの決定や @INC の修正など
+
+	hints を渡す？使う？ (CGI のみ？)	
+
+
+ProcessStart($obj,$args)
+
+   処理本体のスタート
+
+	new
+
+	prepare
+		ml_name と ml_domain の決定
+		CGI からの入力を解析する
+			hints を使う？(CGI のみ？)	
+
+		読み込むべき cf ファイルの決定
+
+		parse
+			メールを読み込む
+			コマンドラインを解析する
+</screen>
+</para>
+
+</sect1>
+
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/internals/cgi.sgml b/fml/doc/ja/tutorial/internals/cgi.sgml
index 8525bde4..8ab251d4 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.8 2002/07/19 03:21:55 fukachan Exp $
+   $FML: cgi.sgml,v 1.9 2002/07/23 09:34:34 fukachan Exp $
 -->
 
 <chapter id="internalcgi">
@@ -99,6 +99,47 @@ sw   south  se
 </para>
 
 
+<sect2>
+	<title>
+	現在の CGI の画面の構造	
+	</title>
+
+<para>
+以下のような３x３のテーブル構造をとっており、
+<screen>
+run_cgi_main
+			run_cgi_title
+run_cgi_navigator	run_cgi_menu	run_cgi_command_help
+run_cgi_options
+</screen>
+HTML のレベルでは、TABLE 命令を使って疑似的なナビゲーションバーのよう
+なものを作っている。そして、ハッシュテーブルで定義されている関数を決め
+られた順番で実行し、テーブルを作成している。
+</para>
+
+<para>
+run_cgi_main() は何らかの処理をしない限り何も表示しない。
+大抵は「なし」か「OK …」程度。エラーメッセージを表示することもある。
+また、この関数はＭＬ一覧などをきちんと最新の情報にするために、
+画面を描く前に実行する必要がある。
+</para>
+
+<para>
+ちなみに、run_cgi_main() は個々の関数を呼び出すためのトップレベルのア
+ダプター層で、FML::CGI::Menu::Admin に定義されている。個々のコマンドは 
+makefml の時と同様にこの関数経由で実行される。
+</para>
+
+<para>
+ただし、ログやメンバーリスト一覧のように run_cgi_menu() から結果の表示
+をしているものもある。これは表示のオプションの指定をさせるために、
+run_cgi_main() ではなく run_cgi_menu() 経由で表示しているともいえるの
+だが、なにしろコマンドの結果の表示が長いので、今のように menu() 経由の
+ほうがよいと思われる。
+</para>
+
+</sect2>
+
 </sect1>