reorder

3 files changed, 179 insertions, 178 deletions

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>