merget purpose.html

6 files changed, 211 insertions, 4 deletions

diff --git a/fml/doc/tutorial/.cvsignore b/fml/doc/tutorial/.cvsignore
index 04e74a53..e855c1c8 100644
--- a/fml/doc/tutorial/.cvsignore
+++ b/fml/doc/tutorial/.cvsignore
@@ -1 +1,2 @@
 fml-devel.fot
+fml-devel
diff --git a/fml/doc/tutorial/Makefile b/fml/doc/tutorial/Makefile
index d25fce28..26bc9477 100644
--- a/fml/doc/tutorial/Makefile
+++ b/fml/doc/tutorial/Makefile
@@ -1,3 +1,9 @@
+#
+# $FML$
+#
+
+TARGET_DIR = ../../../Documentation/ja/tutorial
+
 all: export
 
 html:
@@ -9,5 +15,5 @@ clean:
 	rm -fr fml-devel
 
 export: html
-	rsync -av fml-devel/@*/ ../../../Documentation/ja/tutorial/
-
+	rsync -a fml-devel/@*/ $(TARGET_DIR)/
+	rsync -a *.gif         $(TARGET_DIR)/
diff --git a/fml/doc/tutorial/architecture.gif b/fml/doc/tutorial/architecture.gif
new file mode 100644
index 00000000..4f185758
--- /dev/null
+++ b/fml/doc/tutorial/architecture.gif
diff --git a/fml/doc/tutorial/fml-devel.sgml b/fml/doc/tutorial/fml-devel.sgml
index 8cb4187a..b7c9e24b 100644
--- a/fml/doc/tutorial/fml-devel.sgml
+++ b/fml/doc/tutorial/fml-devel.sgml
@@ -3,13 +3,14 @@
 <!entity terms     SYSTEM "terms.sgml">
 <!entity install   SYSTEM "install.sgml">
 <!entity reference SYSTEM "reference.sgml">
+<!ENTITY architecture SYSTEM "architecture.gif" ndata gif>
 ]>
 
 <!--
 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.3 2001/04/22 06:59:52 fukachan Exp $
+$FML: fml-devel.sgml,v 1.4 2001/04/22 09:13:04 fukachan Exp $
 -->
 
 <book>
diff --git a/fml/doc/tutorial/intro.sgml b/fml/doc/tutorial/intro.sgml
index 0daf429d..9d9d5806 100644
--- a/fml/doc/tutorial/intro.sgml
+++ b/fml/doc/tutorial/intro.sgml
@@ -1,7 +1,7 @@
 <!-- 
 	すでに <chapter> 〜 </chapter> の中で include されていることに注意
 
-	$FML$
+	$FML: intro.sgml,v 1.2 2001/04/22 09:13:26 fukachan Exp $
 -->
 
 <title>fml5 (仮名) プロジェクトの目的</title>
@@ -11,6 +11,16 @@ fml-devel は将来 fml 5.0 になるであろうという…
 </para>
 
 
+<!-- ========================================================
+		section 1
+     ========================================================
+-->
+
+<sect1>
+
+<title> fml-devel プロジェクトの構想 </title>
+
+
 <para>
 fml-devel とも呼ばれている fml 5.0 プロジェクトは、
 fml 4.0 の再構想(refactoring)とその実装(例)の構築
@@ -55,3 +65,164 @@ fml 5.0 のアルファ版のアルファ版のアルファ版
 スれていく予定です。
 逆に 5.0 は本当の開発用のコード( fml-current )ということになります。
 </PARA>
+
+</sect1>
+
+
+<!-- ========================================================
+		section 2
+     ========================================================
+-->
+
+<sect1>
+
+<title> 開発ブランチの関係  </title>
+
+<programlisting>
+             -----------------------------> 5.0 (本プロジェクトの目標)
+                       ↑↓交流
+1.2  〜 4.0 ------------------------------> 4.0-current
+              |      |
+            4.0.1   4.0.2 .... (リリース / 4.0-stable バージョン)
+</programlisting>
+
+</sect1>
+
+
+<!-- ========================================================
+		section 3
+     ========================================================
+-->
+
+<sect1>
+
+<title> 構想（詳細）</title>
+
+<para>
+5.0 のアイデアのついて、ご意見・御感想をお待ちしております。
+端的にいえば 4.0 のここは受け継ぎたいが、あの機能は
+どうでもよいとか、あの機能はこう実装するべきだなどといった
+意見も募集しています。
+</para>
+
+
+<itemizedlist>
+
+   <listitem>
+	<para>
+	設定ファイルとメニュープログラムの負荷を少なくしたい
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+	全部 perl module 形式 (要 5.004 以降)
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+	CUI (makefml) インターフェイスおよび CGI インターフェイス
+	</para>
+	<para>
+	これは従来通りのもの。
+	ただしより統合化され、
+	よりメニューなどが書きやすいものであるように
+	(実装者が楽できる設定ファイル形式がのぞましい et.al.)
+	</para>
+   </listitem>
+
+   <listitem>
+	<para>
+	乖離層
+	</para>
+
+	<itemizedlist>
+
+	   <listitem>
+		<para>
+		バージョンアップを簡単にできるように
+		</para>
+	   </listitem>
+
+	   <listitem>
+		<para>
+		CPAN モジュール使いまくり
+		 (ただし、できるだけ直接使うより、
+		一層被せておくほうがよい)
+		</para>
+	   </listitem>
+
+	   <listitem>
+		<para>
+		3rd party 用ディレクトリ
+		</para>
+	   </listitem>
+
+	</itemizedlist>
+   </listitem>
+
+   <listitem>
+	<para>
+	統一化されたメンバーリストなどへのアクセスをできるだけ抽象化する。
+	</para>
+		
+		<itemizedlist>
+		
+		   <listitem>
+			<para>
+				ファイル (実装済み)
+			</para>
+		   </listitem>
+		
+		   <listitem>
+			<para>
+				/etc/group (実装済み)
+			</para>
+		   </listitem>
+		
+		   <listitem>
+			<para>
+				NIS (実装済み)
+			</para>
+		   </listitem>
+		
+		   <listitem>
+			<para>
+				SQL (プロトタイプは実装済み)
+			</para>
+		   </listitem>
+		
+		   <listitem>
+			<para>
+				LDAP
+			</para>
+		   </listitem>
+		
+	</itemizedlist>
+
+	<para>
+	実際には効率の問題もあり、
+	あらゆる抽象化は重たくなってしまう。
+	しかし少々重くなっても実装しよう。
+	</para>		
+   </listitem>
+
+   <listitem>
+	<para>
+	IPv4/IPv6 ready (実装済み)
+	</para>
+   </listitem>
+
+</itemizedlist>
+</sect1>
+
+
+<!-- =================================================================== -->
+<sect1>
+
+<title> アーキテクチャア・イメージ </title>
+
+<graphic entityref="architecture"></graphic>
+
+</sect1>
diff --git a/fml/doc/tutorial/terms.sgml b/fml/doc/tutorial/terms.sgml
new file mode 100644
index 00000000..76180193
--- /dev/null
+++ b/fml/doc/tutorial/terms.sgml
@@ -0,0 +1,28 @@
+<title>
+	本チュートリアル中における用語について
+</title>
+	
+<variablelist>
+
+   <varlistentry>
+	<term> % </term>
+	<listitem>
+	<para>	一般ユーザのプロンプト	</para>
+	</listitem>
+   </varlistentry>
+
+   <varlistentry>
+	<term> # </term>
+	<listitem>
+	<para>	ユーザ root のプロンプト </para>
+	</listitem>
+   </varlistentry>
+
+   <varlistentry>
+	<term> fml4 </term>
+	<listitem>
+	<para>	fml 4.0 シリーズのこと </para>
+	</listitem>
+   </varlistentry>
+
+</variablelist>