clean up Japanese

resolve some warning by openjade e.g. tags in table entries

4 files changed, 73 insertions, 74 deletions

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 @@
 <!--
-	$FML: bootloader.sgml,v 1.2 2001/04/24 06:51:59 fukachan Exp $
+	$FML: bootloader.sgml,v 1.1.1.1 2001/05/01 14:52:05 fukachan Exp $
 -->
 
 <chapter id="bootloader">    	
@@ -11,41 +11,58 @@
 fml 5.0 にはインストールされている fml のバージョン依存性を考慮するた
 めに、実行時には本章で述べるようなブートストラップの過程があります。
 
-<programlisting>
+<screen>
 boot していくイメージ
 
 libexec/loader -> 
      FML::Process::Switch -> 
          FML::Process::Flow -> 
               FML::Process::それぞれのプログラムのモジュール
-</programlisting>
+</screen>
 </para>
 
 
 <sect1>
-<title> 例: 配送の場合 </title>
+   <title> 例: 配送の場合 </title>
 
 <para>
 loader から次々と呼ばれていく様子は、例えば配送処理の場合、次のよう
-になる。
+になります。
+</para>
+
+<para>
+libexec/loader は /etc/fml/main.cf を読みこみます。
+fml_version 変数から使うべきライブラリのバージョンを決めます。
+例えば fml_vesrion が current-20010501 となっていたら
+/usr/local/lib/fml/current-20010501/ 以下にあるライブラリを使うといった
+具合です。
+</para>
 
-<programlisting>
-libexec/loader は FML::Process::Switch をロードし、
-FML::Process::Distribute を実行すると決める。
+<para>
+@INC を設定した後、
+loader は FML::Process::Switch をロードし、
+$0 を調べます。
+その名前から自分の仕事は配送処理だと知ります。
+配送処理なので
+FML::Process::Distribute をロードし、配送処理に移ります。
+</para>
 
-FML::Process::Flow::ProcessStart() は引数として
+<para>
+こういった処理は見かけ上
+FML::Process::Flow::ProcessStart() という関数が制御しています。
+ProcessStart() が引数として
 FML::Process::Distribute を渡され、
-FML::Process::Distribute を実行していく。
-</programlisting>
+FML::Process::Distribute を実行していくという流れになります。
 </para>
+
 </sect1>
 
 
 <sect1>
-<title> FML::Process:: クラスの階層構造 </title>
+  <title> FML::Process:: クラスの階層構造 </title>
 
 <para>
-<programlisting>
+<screen>
 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  ... その他 ...
-</programlisting>
+</screen>
 
 =&gt;
 <ulink url="../../../fml/lib/FML/Process/programs.ja.html">
@@ -132,12 +149,12 @@ FML::Process::それぞれのプログラムのモジュールについて
 		FML::Process::Flow の中に、
 		どのように fml プロセスを実行するかが
 		定義されています。
-<programlisting>
+<screen>
 $process = new FML::Process::なにか;
 $process->prepare($args);
 $process->run($args);
 $process->finish($args);
-</programlisting>
+</screen>
 		のように実行されています。
 		各プロセスは、それぞれについて適当な関数を
 		用意してください。
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 @@
 <!--
-	$FML: main.cf.sgml,v 1.1.1.1 2001/05/01 14:52:05 fukachan Exp $	
+	$FML: config.cf.sgml,v 1.1 2001/05/05 03:53:40 fukachan Exp $	
 -->
 
 <chapter>
@@ -12,15 +12,19 @@
 
 <para>
 各ＭＬごとにさまざまなカスタマイズをすることができます。
+この点は &fml4; でも &fml5; でも同様です。
+</para>
+
+<para>
 そのために &fml4; では
 各ＭＬのホームディレクトリ $DIR に config.ph というファイルがあります。
 これは .ph という名前でわかる通り perl script です。
 </para>
 
 <para>
-perl script にはいくつか問題があります。
-perl script なので、perl が許す限りの自由な書き方ができます。
-これが config.ph の最大の問題です。
+この perl script 方式にはいくつか問題があります。
+例えば perl script なので、perl が許す限りの自由な書き方ができます。
+これは config.ph の最大の問題です。
 makefml や CGI をはじめとする設定インターフェイスを書きにくいのです。
 </para>
 
@@ -31,11 +35,12 @@ cf というファイルと config.ph という
 </para>
 
 <para>
-しかし、これはこれで２つにわかれていることから保守しにくいものです。
+しかし、これはこれで２つのファイルに分かれてしまう点が
+保守しにくさを生みます。
 よって &fml5; では、設定インターフェイスにやさしい
 新フォーマットを提唱します。
 それが config.cf です。
-これは本質的に postfix 風のフォーマットといってよいでしょう。
+これは本質的に postfix 風のフォーマットです。
 </para>
 
 </sect1>
@@ -112,6 +117,10 @@ b = 値4/値2/値3
 『サイト固有の定義』、
 『ドメイン固有の定義』
 などを別のファイルに分離することができます。
+デフォルトでは分離されています。
+</para>
+
+<para>
 fml は起動時にそれらのファイルを順番に読みこみ、
 最後にＭＬ固有の config.cf を読み込みます。
 そして、その後に変数の展開処理を行ないます。
@@ -125,7 +134,13 @@ fml は起動時にそれらのファイルを順番に読みこみ、
 
 <para>
 $ をふくむ変数の値の代入が行なわれると、
-次回値を取り出すメソッドが呼ばれた際に、再展開が行なわれます。
+次に値を取り出すメソッド
+   <footnote>
+   <para>
+   perl の tie 操作
+   </para>
+   </footnote>
+が呼ばれた際に、変数の再展開が行なわれます。
 </para>
 
 <para>
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 @@
 <!-- 
-	$FML: design.sgml,v 1.3 2001/04/24 13:33:34 fukachan Exp $
+	$FML: design.sgml,v 1.1 2001/05/01 15:16:27 fukachan Exp $
 -->
 
 <chapter id="design">
@@ -251,33 +251,12 @@ fml をリファクトリングするアイデア
 	<row>
 	<entry>	</entry>
 	<entry>
-	設定ファイル形式
-	<itemizedlist>
-		<listitem>
-		<para>
-		 cf と config.ph を統合化する
-		</para>
-		</listitem>
-
-		<listitem>
-		<para>
-		 配列を表現できる形式
-		</para>
-		</listitem>
-
-		<listitem>
-		<para>
-		 メニュープログラムが楽できるフォーマットを
-		</para>
-		</listitem>
-
-		<listitem>
-		<para>
-		 原則として”設定ファイル”という名のものは
-		     どれも同じフォーマットとする。
-		</para>
-		</listitem>
-	</itemizedlist>
+	設定ファイルの形式は
+		cf と config.ph を統合化したようなもので、
+		配列を表現できる形式とする。
+		メニュープログラムが楽できるフォーマットにしたい。
+		原則として”設定ファイル”という名のものは
+		どれも同じフォーマットとする。
 	</entry>
 	<entry>
 	</entry>
@@ -286,27 +265,7 @@ fml をリファクトリングするアイデア
 
 	<row>
 	<entry>	</entry>
-	<entry> 変数の命名規則
-	<itemizedlist>
-		<listitem>
-		<para>
-		USE_機能
-		</para>
-		</listitem>
-
-		<listitem>
-		<para>
-		機能_TYPE
-		</para>
-		</listitem>
-
-		<listitem>
-		<para>
-		機能_ATTRIBUTES
-		</para>
-		</listitem>
-
-	</itemizedlist>
+	<entry> 変数の命名規則の規格化
 	</entry>
 	<entry>
 		”USE_ほえ”および”ほえ_TYPE”形式か？	
@@ -383,7 +342,7 @@ fml をリファクトリングするアイデア
 
 <title> アーキテクチャア・イメージ </title>
 
-<graphic entityref="architecture"></graphic>
+<graphic entityref="image.architecture"></graphic>
 
 </sect1>
 
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 @@
 <!--
-	$FML: main.cf.sgml,v 1.1 2001/04/24 11:40:58 fukachan Exp $	
+	$FML: main.cf.sgml,v 1.1.1.1 2001/05/01 14:52:05 fukachan Exp $	
 -->
 <sect1 id="main.cf">
 <title> /etc/fml/main.cf </title>
@@ -12,6 +12,14 @@ fml のプログラム群が起動する時に参照します。
 
 
 <para>
+main.cf はこのようなファイルです。
+
+フォーマットは
+<screen>
+変数名 = 値
+</screen>
+です。
+
 <screen>
 # fml version
 #   This is important