reorder

6 files changed, 205 insertions, 193 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 336a8e2c..5e39d718 100644
--- a/fml/doc/ja/tutorial/book.sgml
+++ b/fml/doc/ja/tutorial/book.sgml
@@ -2,7 +2,7 @@
 This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
 to generate various output formats.
 
-$FML: book.sgml,v 1.21 2001/11/24 03:22:52 fukachan Exp $
+$FML: book.sgml,v 1.22 2001/11/24 03:28:57 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -59,29 +59,38 @@ $FML: book.sgml,v 1.21 2001/11/24 03:22:52 fukachan Exp $
 
 
   <part>
-	<title> 内部構造 </title>
+	<title> デザイン </title>
 	<partintro>
 	<para>
-	本パートでは開発者向けの内容についてまとめます。
+	本パートではデザインの話をします。
 	</para>
 	</partintro>
 
-	<!-- 以下、各章が並ぶ -->
 	&chapter.design;
-	&chapter.cvstree;
 	&chapter.programingstyle; 
-        &chapter.message;
-        &chapter.message.nl;
-	&chapter.db;
-	&chapter.dbms;
+  </part>
 
-	<!-- 以下、各章が並ぶ -->
+
+  <part>
+	<title> 内部構造 </title>
+	<partintro>
+	<para>
+	本パートでは開発者向けの内容についてまとめます。
+	</para>
+	</partintro>
+
+	<!-- ブートの様子 -->
 	&chapter.bootloader;
         &chapter.config.cf;
 
 	<!-- 記事の配送とコマンドの処理 -->
         &chapter.delivery;
+        &chapter.message;
         &chapter.replybyfml;
+
+	<!-- その他 -->
+	&chapter.db;
+	&chapter.dbms;
   </part>
 
 
@@ -104,8 +113,9 @@ $FML: book.sgml,v 1.21 2001/11/24 03:22:52 fukachan Exp $
   -->
   <part>
 	<title> 付録 </title>
-	&chapter.glossary;
 
+	&chapter.glossary;
+	&chapter.cvstree;
 	&chapter.docbook;
 	&chapter.cvstags;
 	&chapter.inet6;
diff --git a/fml/doc/ja/tutorial/devel/cvstree.sgml b/fml/doc/ja/tutorial/devel/cvstree.sgml
index c87dce07..8a2c6c43 100644
--- a/fml/doc/ja/tutorial/devel/cvstree.sgml
+++ b/fml/doc/ja/tutorial/devel/cvstree.sgml
@@ -2,7 +2,7 @@
 	$FML
 -->
 
-<chapter id="cvs.dirhier">
+<appendix id="cvs.dirhier">
 	<title>
 	cvs repository の構造
 	</title>
@@ -185,4 +185,4 @@ CPAN/dist/ はオリジナルを保存する場所なので、変更してはいけません。
 	
 </sect1>
 
-</chapter>
+</appendix>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index a95d1b5f..845afc80 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.21 2001/11/24 03:22:54 fukachan Exp $
+	$FML: chapters.ent,v 1.22 2001/11/24 06:54:46 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -67,7 +67,8 @@
 
 <!-- メッセージの取り扱い -->
 <!entity chapter.message         SYSTEM "message/chapter.sgml">
-<!entity chapter.message.nl      SYSTEM "message/language.sgml">
+<!entity sect.message.nl         SYSTEM "message/language.sgml">
+<!entity sect.message.discuss    SYSTEM "message/discussion.sgml">
 <!entity chapter.replybyfml      SYSTEM "message/reply.sgml">
 
 
diff --git a/fml/doc/ja/tutorial/message/chapter.sgml b/fml/doc/ja/tutorial/message/chapter.sgml
index 86de2a7a..635d6bde 100644
--- a/fml/doc/ja/tutorial/message/chapter.sgml
+++ b/fml/doc/ja/tutorial/message/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: message.sgml,v 1.7 2001/10/13 08:47:57 fukachan Exp $	
+	$FML: chapter.sgml,v 1.1 2001/11/24 03:22:55 fukachan Exp $	
 -->
 
 <chapter id="mail.manipulation">
@@ -105,4 +105,9 @@ MIME::Lite クラスへ
 
 </sect1>
 
+
+<!-- 他国語化について -->
+&sect.message.nl;
+&sect.message.discuss;
+
 </chapter>
diff --git a/fml/doc/ja/tutorial/message/discussion.sgml b/fml/doc/ja/tutorial/message/discussion.sgml
new file mode 100644
index 00000000..3291fa1d
--- /dev/null
+++ b/fml/doc/ja/tutorial/message/discussion.sgml
@@ -0,0 +1,170 @@
+<!--
+   $FML$
+-->
+
+<sect1>
+   <title> 議論: エラーメッセージを返す </title>
+
+<para>
+適宜、エラーメッセージを送信者に返す必要があります。
+それもエラーメッセージは言語依存です。
+何らかの形で言語変換をしてから送り出すわけです。
+</para>
+
+
+<!-- ===================================================== -->
+<sect2>
+   <title> fml 4.0 の場合 </title>
+
+<para>
+fml 4.0 では
+<screen> 
+   Mesg(*e, キーワード, デフォルトのメッセージ, 変換に使う引数);
+</screen> 
+の形で呼び出します。
+</para>
+
+<para>
+/usr/local/fml/messages/Japanese/ 
+以下にあるファイル群に対して、
+キーワード検索を行ないます。
+各ファイルにはカテゴリごとに分類されたキーワードとメッセージが
+定義されています。
+つまり各ファイルに複数のキーワードが定義されています。
+</para>
+
+<para>
+例えば、キーワードが not_found の場合、
+/usr/local/fml/messages/Japanese/kern
+の not_found という欄が該当します。 
+</para>
+
+</sect2>
+
+
+
+<!-- ===================================================== -->
+<sect2>
+   <title> fml 5.0 はどうするべきか？ </title>
+
+<para>
+一つのファイルに一つのキーワードを持つのと、
+カテゴリごとに複数のキーワードを持つのとどちらが
+カスタマイズしやすいのでしょうか？
+僕には良くわかりません。
+</para>
+
+<sect3>
+   <title>
+    X/Open Portability Guide Issue 4 Version 2 (``XPG4.2'')
+   </title>
+
+<para>
+XPG (X/Open の規格)を使う場合は
+<screen>
+catgets(catd, set_id, msg_id, char *s);
+</screen>
+で、LOCALE_○○ で指定された言語へ変換しています。
+	<footnote>
+	<para>
+	ここで s はデフォルトのメッセージとなります。
+	</para>
+	</footnote>
+例えば、次のような使い方をします。
+<screen>
+printf(catgets(catd, 30,  4,  "%s: Internal match error.\n"), progname);
+</screen>
+この時、
+locale の定義ファイル(
+例: /usr/pkg/share/nls/ja_JP.EUC/プログラム名.cat
+)
+の中の se 30、エントリ 4 のメッセージに変換してくれます。
+</para>
+
+</sect3>
+
+<sect3>
+   <title>
+   fml 5.0: とりあえずの方針     
+   </title>
+
+<para>
+問題の一つは locale に対応するか？という問題です。
+makefml を筆頭に、各種コマンド群のエラーメッセージの日本語化
+を考えると、
+locale を考えておくのも悪くはないのかとも思います。
+この場合は locale ぽくするために
+<screen>
+/usr/local/lib/fml/バージョン/messages/ja_JP.EUC/kern 
+
+1: %s は見つかりません
+2: %s は %d のエラーです
+</screen>
+といったものにしておくと後で便利そうです。
+</para>
+
+<para>
+逆に、一つのキーワードごとに別のファイルにしておく構成も可能です。
+これは特定の一つのキーワードだけ変えたい場合に便利そうです。
+</para>
+
+<para>
+もし、後者の方法を試してみることにすると、
+<screen>
+FML::Message::ja::キーワード
+</screen>
+というクラスをじゃんじゃん作るような作り方になるでしょう。
+例えば
+<screen>
+FML::Message::ja::not_found
+</screen>
+などと2、300個のファイルが作られることになります（まじか？）。
+</para>
+
+<para>
+この方法の問題点は
+<itemizedlist>
+   <listitem>
+	<para>
+        ファイルがバラバラになる
+        (逆に長所としてカスタマイズしやすくなる) 
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+        ファイルがバラバラになることで locale ぽくなくなるが？
+        locale 対応を考えると面倒じゃないだろうか？
+	</para>
+   </listitem>
+
+</itemizedlist>
+あたりにあるでしょう。
+</para>
+
+
+<para>
+また、各メッセージテンプレートはどのようなものであるべきだろうか？
+後者の場合、
+<screen>
+sub not_found
+{
+   my ..  = @_;
+
+   return <<"_EOF_"
+$sender はどうーたら
+_EOF_
+}
+</screen>
+といった関数を一杯作ることもできます。
+つまり単なる引数ではなく意味の分かりやすいものにすることを考えたわけです。
+しかし、これは本当にカスタマイズしやすいでしょうか？
+locale 化を考えるなら、これはこれで面倒な気がするわけですが…
+</para>
+
+</sect3>
+
+
+</sect2>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/message/language.sgml b/fml/doc/ja/tutorial/message/language.sgml
index 71a86c38..d963d03f 100644
--- a/fml/doc/ja/tutorial/message/language.sgml
+++ b/fml/doc/ja/tutorial/message/language.sgml
@@ -1,15 +1,11 @@
 <!--
-   $FML: errormessage.sgml,v 1.4 2001/10/12 11:29:38 fukachan Exp $
+   $FML: language.sgml,v 1.1.1.1 2001/10/13 08:33:23 fukachan Exp $
 -->
 
-<chapter id="message.nl">
-	<title>
-	メッセージの多国語化問題
-	</title>
 
-<sect1>
+<sect1 id="message.nl">
 	<title>
-	reply_message_nl() の使い方
+	メッセージの多国語化問題: reply_message_nl() の使い方
 	</title>
 
 <para>
@@ -46,173 +42,3 @@ $_args_address
 </para>
 
 </sect1>
-
-
-<sect1>
-   <title> 議論: エラーメッセージを返す </title>
-
-<para>
-適宜、エラーメッセージを送信者に返す必要があります。
-それもエラーメッセージは言語依存です。
-何らかの形で言語変換をしてから送り出すわけです。
-</para>
-
-
-<!-- ===================================================== -->
-<sect2>
-   <title> fml 4.0 の場合 </title>
-
-<para>
-fml 4.0 では
-<screen> 
-   Mesg(*e, キーワード, デフォルトのメッセージ, 変換に使う引数);
-</screen> 
-の形で呼び出します。
-</para>
-
-<para>
-/usr/local/fml/messages/Japanese/ 
-以下にあるファイル群に対して、
-キーワード検索を行ないます。
-各ファイルにはカテゴリごとに分類されたキーワードとメッセージが
-定義されています。
-つまり各ファイルに複数のキーワードが定義されています。
-</para>
-
-<para>
-例えば、キーワードが not_found の場合、
-/usr/local/fml/messages/Japanese/kern
-の not_found という欄が該当します。 
-</para>
-
-</sect2>
-
-
-
-<!-- ===================================================== -->
-<sect2>
-   <title> fml 5.0 はどうするべきか？ </title>
-
-<para>
-一つのファイルに一つのキーワードを持つのと、
-カテゴリごとに複数のキーワードを持つのとどちらが
-カスタマイズしやすいのでしょうか？
-僕には良くわかりません。
-</para>
-
-<sect3>
-   <title>
-    X/Open Portability Guide Issue 4 Version 2 (``XPG4.2'')
-   </title>
-
-<para>
-XPG (X/Open の規格)を使う場合は
-<screen>
-catgets(catd, set_id, msg_id, char *s);
-</screen>
-で、LOCALE_○○ で指定された言語へ変換しています。
-	<footnote>
-	<para>
-	ここで s はデフォルトのメッセージとなります。
-	</para>
-	</footnote>
-例えば、次のような使い方をします。
-<screen>
-printf(catgets(catd, 30,  4,  "%s: Internal match error.\n"), progname);
-</screen>
-この時、
-locale の定義ファイル(
-例: /usr/pkg/share/nls/ja_JP.EUC/プログラム名.cat
-)
-の中の se 30、エントリ 4 のメッセージに変換してくれます。
-</para>
-
-</sect3>
-
-<sect3>
-   <title>
-   fml 5.0: とりあえずの方針     
-   </title>
-
-<para>
-問題の一つは locale に対応するか？という問題です。
-makefml を筆頭に、各種コマンド群のエラーメッセージの日本語化
-を考えると、
-locale を考えておくのも悪くはないのかとも思います。
-この場合は locale ぽくするために
-<screen>
-/usr/local/lib/fml/バージョン/messages/ja_JP.EUC/kern 
-
-1: %s は見つかりません
-2: %s は %d のエラーです
-</screen>
-といったものにしておくと後で便利そうです。
-</para>
-
-<para>
-逆に、一つのキーワードごとに別のファイルにしておく構成も可能です。
-これは特定の一つのキーワードだけ変えたい場合に便利そうです。
-</para>
-
-<para>
-もし、後者の方法を試してみることにすると、
-<screen>
-FML::Message::ja::キーワード
-</screen>
-というクラスをじゃんじゃん作るような作り方になるでしょう。
-例えば
-<screen>
-FML::Message::ja::not_found
-</screen>
-などと2、300個のファイルが作られることになります（まじか？）。
-</para>
-
-<para>
-この方法の問題点は
-<itemizedlist>
-   <listitem>
-	<para>
-        ファイルがバラバラになる
-        (逆に長所としてカスタマイズしやすくなる) 
-	</para>
-   </listitem>
-
-   <listitem>
-	<para>
-        ファイルがバラバラになることで locale ぽくなくなるが？
-        locale 対応を考えると面倒じゃないだろうか？
-	</para>
-   </listitem>
-
-</itemizedlist>
-あたりにあるでしょう。
-</para>
-
-
-<para>
-また、各メッセージテンプレートはどのようなものであるべきだろうか？
-後者の場合、
-<screen>
-sub not_found
-{
-   my ..  = @_;
-
-   return <<"_EOF_"
-$sender はどうーたら
-_EOF_
-}
-</screen>
-といった関数を一杯作ることもできます。
-つまり単なる引数ではなく意味の分かりやすいものにすることを考えたわけです。
-しかし、これは本当にカスタマイズしやすいでしょうか？
-locale 化を考えるなら、これはこれで面倒な気がするわけですが…
-</para>
-
-</sect3>
-
-
-</sect2>
-
-</sect1>
-
-</chapter>