merge announce.html terms.html to tutorial

7 files changed, 269 insertions, 242 deletions

diff --git a/fml/doc/ja/htdocs/announce.html b/fml/doc/ja/htdocs/announce.html
deleted file mode 100644
index a48a809a..00000000
--- a/fml/doc/ja/htdocs/announce.html
+++ /dev/null
@@ -1,127 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
-<TITLE>
-fml5 (仮名) プロジェクト アナウンス
-</TITLE>
-<META http-equiv="Content-Type"
-	content="text/html; charset=EUC-JP">
-</HEAD>
-
-<BODY BGCOLOR="#E6E6FA">
-<!-- ================== body =========================================== -->
-
-<PRE>
-	次世代 fml プロジェクト
-	http://www.fml.org/devel/fmlsrc/index.ja.html
-
-		Copyright (C) 2001 Ken'ichi Fukamachi
-		改変しない限り再配布は自由です
-
-
-
-fml 5.0  への道(はるかなる道)について現在次のように構想しています。
-基本的な考え方は fml 4.0 の”機能”を再構想/再実装することです。
-
-まず最初にしたいことは 4.0 の機能についての再検討です。例えば
-
-   5.0 へ引き継ぐものは何か？
-   5.0 でもっとうまく、よりカスタマイズしやすいものに実装できないか？
-   もう要らないものは何か？
-
-についての意見を募集したいと思っています。ですが、漠然と議論してもしょ
-うがないので、議論の叩き台としてある程度動くものを作りました。
-
-	ftp://ftp.fml.org/pub/fml-devel/
-
-にあります。まだまだ 5.0 の α 版ではなく、プロトタイプですらないので、
-リリースなどではありません。これは、あくまでもアイデアを表現するための
-ものですが、配送プログラムとしては十分動きます。fml-devel ＭＬをはじめ
-として、いくつか運用テストに入っているものがあります。
-＃注: 実運用には fml-devel を使わずに 4.0 stable を使って下さい。
-＃    fml-devel は開発用 fml-current ですらありません。
-
-現状動いている機能は
-
-	fml 1.2 相当の最低限の機能
-	  + postfix スタイルの設定ファイル 
-	  + IPv6 
-	  + チケットシステム(最小限の機能、CGI 含む)
-	  + 抽象化 IO 層
-		メンバーファイルをファイル、/etc/group, NIS, MySQL 
-		から取り出す。
-		＃ 3 行くらい変更すれば PostgreSQL も動くはず
-
-程度です。ざっくりとしたイメージは sendmail と postfix のような違いか
-と個人的には思っています。
-
-
-○ fml 4.0 と 5.0 の関係
-
-http://www.fml.org/devel/fmlsrc/fml/doc/purpose.ja.html 
-
-4.0 と 5.0 はアイデアは継承していても、起源は別です。
-図解すれば次のようなものといえます。
-
-             -----------------------------> 5.0 (本プロジェクトの目標)
-                       ↑↓交流
-1.2  〜 4.0 ------------------------------> 4.0-current
-              |      |
-            4.0.1   4.0.2 .... (リリース / 4.0-stable バージョン)
-
-今後 4.0 シリーズに投入する新機能は、原則として 5.0 ライン上で作ったも
-のを逆輸入する形になるでしょう。
-
-
-○ fml5で既に動く機能                             
-
-http://www.fml.org/devel/fmlsrc/fml/doc/built_already.ja.html
-
-
-これらのものは /usr/local/libexec/fml以下にインストールされます。実際には 
-/usr/local/libexec/fml/loaderへのリンクです。起動される時の名前で振舞いを変
-えています。 
-
-注意: fml5ではすべてのプログラムは /usr/local/libexec/fml/loaderを経由して
-起動されます。バージョン依存性を処理するために、つねにこの loaderを通して
-起動していくことになっています。 
-+------------------+--------------------------------------------------------+
-|fml.pl            |配送処理をする。subjectを書き換える。スプールに記事とし |
-|distribute        |て溜める。IPv6をしゃべる。チケット番号をふる。et. al.   |
-+------------------+--------------------------------------------------------+
-|command           |プログラム自体は動きますが、機能するコマンドはまだない  |
-|fml.pl --ctladdr  |です。                                                  |
-+------------------+--------------------------------------------------------+
-|makefml           |登録と削除関係、および最低限のＭＬの作成だけは動きます( |
-|                  |add subscribe                                           |
-|                  |bye unsubscribe resign remove                           |
-|                  |そして newml)。使い方は fml 4.0と一緒です。             |
-|                  |% makefml add elenaアドレス                             |
-|                  |% makefml bye elenaアドレス                             |
-|                  |% makefml newml elena                                   |
-+------------------+--------------------------------------------------------+
-|makefml.cgi       |makefmlの CGIインターフェイス。うごくけど、まだプロトタ |
-|                  |イプ。動く機能は makefmlと同等のものです。それは最終的  |
-|                  |に makefmlと同じ関数を呼び出しているからです。          |
-+------------------+--------------------------------------------------------+
-|fmlconf           |変数一覧を表示します                                    |
-+------------------+--------------------------------------------------------+
-|fmldoc            |モジュールのマニュアルを表示する                        |
-|                  |perldocへの wrapperです。                               |
-+------------------+--------------------------------------------------------+
-|fmlticket         |現在のチケットシステムのサマリを表示する                |
-|                  |チケットの close                                        |
-+------------------+--------------------------------------------------------+
-|fmlticket.cgi     |fmlticketの CGI版                                       |
-|                  |チケットを closeする。あるチケットに該当する記事群を表  |
-|                  |示する。                                                |
-+------------------+--------------------------------------------------------+
-|mead              |ま〜だだよ                                              |
-+------------------+--------------------------------------------------------+
-|fmlserv           |ま〜だだよ                                              |
-+------------------+--------------------------------------------------------+
-
-</PRE>
-
-</BODY>
-</HTML>
diff --git a/fml/doc/ja/htdocs/menubar.html b/fml/doc/ja/htdocs/menubar.html
index 18ed838a..abc036e3 100644
--- a/fml/doc/ja/htdocs/menubar.html
+++ b/fml/doc/ja/htdocs/menubar.html
@@ -71,7 +71,8 @@ fml-devel (fml 5.0) project menu
 	<LI>
 	モジュール
 	<BR>
-	<A HREF="terms.html"  TARGET="right">
+	<A HREF="../../../../Documentation/ja/tutorial/glossary.html"
+		TARGET="right">
 	用語集
 	</A>
 	<UL>
diff --git a/fml/doc/ja/htdocs/terms.html b/fml/doc/ja/htdocs/terms.html
deleted file mode 100644
index bb461ee9..00000000
--- a/fml/doc/ja/htdocs/terms.html
+++ /dev/null
@@ -1,110 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
-<TITLE>
-関数名および変数名に関連した用語のまとめ
-</TITLE>
-<META http-equiv="Content-Type"
-	content="text/html; charset=EUC-JP">
-</HEAD>
-
-<BODY BGCOLOR="#E6E6FA">
-<!-- ================== body =========================================== -->
-
-<CENTER>
-関数名および変数名に関連した用語のまとめ
-</CENTER>
-
-<TABLE BORDER=4>
-   <TR>
-	<TD> 	用語/単語の省略形
-	<TD> 	説明
-
-   <TR>
-	<TD>	fml 4
-	<TD>	fml 4.0 シリーズのこと
-
-   <TR>
-	<TD>	fml 5
-		<BR>
-		fml-devel
-	<TD>	遠い将来に 
-		fml 5.0 になるであろうとおもわれる fml-current
-
-   <TR>
-	<TD>	curproc
-	<TD>	"current process"の略
-
-   <TR>
-	<TD>	PCB
-	<TD>	Process Control Block の略。
-		そのプロセス固有の情報を含む。
-		現状 fml 内部でのコンテキスト切替などはないので、
-		UNIX カーネルの PCB とは少し趣が異なります。
-
-   <TR>
-	<TD>	config
-	<TD>	configuration の略
-
-   <TR>
-	<TD>	arg <BR> args
-	<TD>	アーギュメントの略
-
-   <TR>
-	<TD>	fh
-	<TD>	ファイルハンドル( file handle )
-
-   <TR>
-	<TD>	dh
-	<TD>	ディレクトリハンドル( directory handle )
-
-   <TR>
-	<TD>	fp
-	<TD>	関数へのポインタ( function pointer )
-		<BR> 
-		ただし perl では CODE リファレンスと呼ぶべき
-
-   <TR>
-	<TD>	_なになに
-	<TD>	慣習的にパッケージ、クラス、オブジェクト内部で使う
-		変数や関数名に _ ではじまるキーワードを使う。
-
-   <TR>
-	<TD>	rなになに
-	<TD>	r はリファレンスの略。ハンガリアン記法
-		<BR>
-		特別に強調したい場合に使うことがあるが、
-		あまり使っていない。		
-
-   <TR>
-	<TD> 	STR
-	<TD> 	文字列 ( string ) の略
-
-   <TR>
-	<TD> 	日本語コードの略称
-	<TD> 	JIS SJIS EUC などおなじみのもの…
-
-   <TR>
-	<TD> 	2
-	<TD> 	
-		to と発音が一緒のため省略形としてよく使う。
-		類似品として 4 ( for の意味)もある
-		<BR>		  
-		例: STR2EUC (STRing to EUC の略)
-		<BR>
-		<PRE>
-		use String qw(STR2EUC);
-		$euc_string = &STR2EUC($string);
-		</PRE>
-
-   <TR>
-	<TD> 	4
-	<TD> 	for と発音が同じために用いる。
-		<BR>
-		例: まだなし
-
-</TABLE>
-
-<!-- =================================================================== -->
-</BODY>
-</HTML>
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>