merge announce.html terms.html to tutorial

4 files changed, 267 insertions, 4 deletions

diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml
index e03648f2..70efd13e 100644
--- a/fml/doc/ja/tutorial/fml-devel.sgml
+++ b/fml/doc/ja/tutorial/fml-devel.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: fml-devel.sgml,v 1.10 2001/04/24 13:32:53 fukachan Exp $
+$FML: fml-devel.sgml,v 1.11 2001/04/24 15:19:14 fukachan Exp $
 -->
 
 <!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
@@ -75,6 +75,7 @@ $FML: fml-devel.sgml,v 1.10 2001/04/24 13:32:53 fukachan Exp $
   -->
   <part>
 	<title> 付録 </title>
+	&glossary;
 	&docbook;
 	&cvstags;
   </part>
diff --git a/fml/doc/ja/tutorial/glossary.sgml b/fml/doc/ja/tutorial/glossary.sgml
new file mode 100644
index 00000000..3c70a511
--- /dev/null
+++ b/fml/doc/ja/tutorial/glossary.sgml
@@ -0,0 +1,190 @@
+<!--
+	$FML$
+-->
+
+<glossary id="glossary">
+   <title> 用語集(関数名および変数名関連) </title>
+
+
+   <glossentry>
+	<glossterm>	fml 4	</glossterm>
+	<glossdef>
+	<para>
+		fml 4.0 シリーズのこと
+	</para>
+	</glossdef>
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	fml 5 / fml-devel	</glossterm>
+	<glossdef>
+	<para>
+		遠い将来に 
+		fml 5.0 になるであろうとおもわれる fml-current
+	</para>
+	</glossdef>
+
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	curproc	</glossterm>
+	<glossdef>
+	<para>
+		"current process"の略
+	</para>
+	</glossdef>
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	PCB	</glossterm>
+	<glossdef>
+	<para>
+		Process Control Block の略。
+		そのプロセス固有の情報を含む。
+		現状 fml 内部でのコンテキスト切替などはないので、
+		UNIX カーネルの PCB とは少し趣が異なります。
+	</para>
+	</glossdef>
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	config	</glossterm>
+	<glossdef>
+	<para>
+		configuration の略
+	</para>
+	</glossdef>
+
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	arg / args	</glossterm>
+	<glossdef>
+	<para>
+		アーギュメントの略
+	</para>
+	</glossdef>
+
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	fh	</glossterm>
+	<glossdef>
+	<para>
+		ファイルハンドル( file handle )
+	</para>
+	</glossdef>
+
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	dh	</glossterm>
+	<glossdef>
+	<para>
+		ディレクトリハンドル( directory handle )
+	</para>
+	</glossdef>
+
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	fp	</glossterm>
+	<glossdef>
+	<para>
+		関数へのポインタ( function pointer )。
+		ただし perl では CODE リファレンスと呼ぶべき
+	</para>
+	</glossdef>
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	_なになに	</glossterm>
+	<glossdef>
+	<para>
+		慣習的にパッケージ、クラス、オブジェクト内部で使う
+		変数や関数名に _ ではじまるキーワードを使う。
+	</para>
+	</glossdef>
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm>	rなになに	</glossterm>
+	<glossdef>
+	<para>
+		r はリファレンスの略。ハンガリアン記法。
+		特別に強調したい場合に使うことがあるが、
+		あまり使っていない。		
+	</para>
+	</glossdef>
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm> 	STR	</glossterm>
+	<glossdef>
+	<para>
+	 	文字列 ( string ) の略
+	</para>
+	</glossdef>
+
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm> 	日本語コードの略称	</glossterm>
+	<glossdef>
+	<para>
+	 	JIS SJIS EUC などおなじみのもの…
+	</para>
+	</glossdef>
+   </glossentry>
+
+
+   <glossentry>
+	<glossterm> 	2	</glossterm>
+	<glossdef>
+	<para>
+		to と発音が一緒のため省略形としてよく使う。
+		類似品として 4 ( for の意味)もある
+	</para>
+	<para>
+		例: STR2EUC (STRing to EUC の略)
+<screen>
+use String qw(STR2EUC);
+$euc_string = STR2EUC($string);
+</screen>
+	</para>
+	</glossdef>
+   </glossentry>
+
+ 
+   <glossentry>
+	<glossterm> 	4	</glossterm>
+	<glossdef>
+	<para>
+	 	for と発音が同じために用いる。
+		例はまだなし。
+	</para>
+	</glossdef>
+   </glossentry>
+
+
+</glossary>
diff --git a/fml/doc/ja/tutorial/include.sgml b/fml/doc/ja/tutorial/include.sgml
index bf3d01da..1b70619d 100644
--- a/fml/doc/ja/tutorial/include.sgml
+++ b/fml/doc/ja/tutorial/include.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: include.sgml,v 1.9 2001/04/24 13:16:25 fukachan Exp $
+	$FML: include.sgml,v 1.10 2001/04/24 15:19:14 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -24,7 +24,7 @@
 <!entity programingstyle  SYSTEM "programing_style.sgml">
 <!entity reference SYSTEM "reference.sgml">
 
-
+<!entity glossary     SYSTEM "glossary.sgml">
 <!entity cvstree     SYSTEM "cvstree.sgml">
 <!entity cvstags     SYSTEM "cvstags.sgml">
 
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
index 1fe5b093..0b73637b 100644
--- a/fml/doc/ja/tutorial/preface.sgml
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: preface.sgml,v 1.2 2001/04/24 07:12:29 fukachan Exp $
+	$FML: preface.sgml,v 1.3 2001/04/24 13:33:34 fukachan Exp $
 -->
 
 <preface>
@@ -9,6 +9,78 @@
 <!-- ======================================================== -->
 <sect1>
 
+<title> はるかなる fml 5.0 への道 </title>
+
+<para>
+fml 5.0  への道(はるかなる道)について現在次のように構想しています。
+基本的な考え方は fml 4.0 の”機能”を再構想/再実装することです。
+</para>
+
+<para>
+まず最初にしたいことは 4.0 の機能についての再検討です。
+例えば、次のような項目です。
+
+<itemizedlist>
+
+   <listitem>
+	<para>
+	   5.0 へ引き継ぐものは何か？
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+	   5.0 でもっとうまく、よりカスタマイズしやすいものに実装できないか？
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+	   もう要らないものは何か？
+	</para>
+   </listitem>
+
+</itemizedlist>
+
+についての意見を募集したいと思っています。ですが、漠然と議論してもしょ
+うがないので、議論の叩き台としてある程度動くものを作りました。
+
+	<ulink url="ftp://ftp.fml.org/pub/fml-devel/">
+	ftp://ftp.fml.org/pub/fml-devel/
+	</ulink>
+
+にあります。まだまだ 5.0 の α 版ではなく、プロトタイプですらないので、
+リリースなどではありません。これは、あくまでもアイデアを表現するための
+ものですが、配送プログラムとしては十分動きます。fml-devel ＭＬをはじめ
+として、いくつか運用テストに入っているものがあります。
+</para>
+
+<warning>
+<para>
+	実運用には fml-devel を使わずに 4.0 stable を使って下さい。
+	fml-devel は開発用で、 fml-current ですらありません。
+</para>
+</warning>
+
+<para>
+最初に実装するのは
+<emphasis>
+fml 1.2 相当の最低限の機能
+</emphasis>
+だろうと考えています。
+</para>
+
+<para>
+ざっくりとしたイメージは sendmail と postfix のような違いになるだろう
+と個人的には思っています。
+</para>
+
+</sect1>
+
+
+<!-- ======================================================== -->
+<sect1>
+
 <title> fml-devel プロジェクトの構想 </title>
 
 <para>