Initial revision

9 files changed, 370 insertions, 0 deletions

diff --git a/fml/doc/ja/tutorial/.cvsignore b/fml/doc/ja/tutorial/.cvsignore
new file mode 100644
index 00000000..e855c1c8
--- /dev/null
+++ b/fml/doc/ja/tutorial/.cvsignore
@@ -0,0 +1,2 @@
+fml-devel.fot
+fml-devel
diff --git a/fml/doc/ja/tutorial/00_README b/fml/doc/ja/tutorial/00_README
new file mode 100644
index 00000000..0d376097
--- /dev/null
+++ b/fml/doc/ja/tutorial/00_README
@@ -0,0 +1,9 @@
+file formats in this directory is SGML (Standard Generalized Markup
+Language). 
+
+You can compile it to html format by sgmltools and openjade.
+
+
+
+					Ken'ichi Fukamachi
+					fukachan@fml.org
diff --git a/fml/doc/ja/tutorial/Makefile b/fml/doc/ja/tutorial/Makefile
new file mode 100644
index 00000000..aabd8c7a
--- /dev/null
+++ b/fml/doc/ja/tutorial/Makefile
@@ -0,0 +1,19 @@
+#
+# $FML: Makefile,v 1.4 2001/04/22 12:45:46 fukachan Exp $
+#
+
+TARGET_DIR = ../../../Documentation/ja/tutorial
+
+all: export
+
+html:
+	sgmltools -v -b html -j "-v" fml-devel.sgml 2>&1 |\
+	uniq
+
+clean:
+	find . -type f -print |grep '~' |perl -nple unlink
+	rm -fr fml-devel
+
+export: html
+	rsync -a fml-devel/@*/ $(TARGET_DIR)/
+	rsync -a *.gif         $(TARGET_DIR)/
diff --git a/fml/doc/ja/tutorial/TODO b/fml/doc/ja/tutorial/TODO
new file mode 100644
index 00000000..b7c7955c
--- /dev/null
+++ b/fml/doc/ja/tutorial/TODO
@@ -0,0 +1,16 @@
+announce.ja.html
+built_already.ja.html
+components.ja.html
+cvstag.ja.html
+dirhier.ja.html
+download.ja.html
+extension.ja.html
+guide.ja.html
+install.ja.html
+mailinglist.ja.html
+menubar.ja.html
+refactoring.ja.html
+releng.ja.html
+style.ja.html
+terms.ja.html
+upgrade.ja.html
diff --git a/fml/doc/ja/tutorial/architecture.gif b/fml/doc/ja/tutorial/architecture.gif
new file mode 100644
index 00000000..4f185758
--- /dev/null
+++ b/fml/doc/ja/tutorial/architecture.gif
diff --git a/fml/doc/ja/tutorial/fml-devel.sgml b/fml/doc/ja/tutorial/fml-devel.sgml
new file mode 100644
index 00000000..07f3af4c
--- /dev/null
+++ b/fml/doc/ja/tutorial/fml-devel.sgml
@@ -0,0 +1,54 @@
+<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
+<!entity intro     SYSTEM "intro.sgml">
+<!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.6 2001/04/22 16:10:45 fukachan Exp $
+-->
+
+<book>
+  <bookinfo>
+  <bookbiblio>
+    <title>
+	fml-devel (fml 5.0) チュートリアル
+    </title>
+
+    <authorgroup>
+	<corpauthor>
+	Ken'ichi Fukamachi
+	</corpauthor>
+    </authorgroup>
+
+    <copyright>
+		<year/2001/<holder/Ken'ichi Fukamachi/
+    </copyright>
+
+  </bookbiblio>
+
+    <legalnotice>
+      <para>
+	All rights reserved. This program is free software; you can
+	redistribute it and/or modify it under the same terms as Perl itself. 
+      </para>
+    </legalnotice>
+
+  </bookinfo>
+
+  <TOC></TOC>
+
+  <chapter id="intro">
+    &intro;
+  </chapter>
+
+  <chapter id="reference">
+	&reference;
+  </chapter>
+
+</book>
diff --git a/fml/doc/ja/tutorial/intro.sgml b/fml/doc/ja/tutorial/intro.sgml
new file mode 100644
index 00000000..7ba48a79
--- /dev/null
+++ b/fml/doc/ja/tutorial/intro.sgml
@@ -0,0 +1,228 @@
+<!-- 
+	すでに <chapter> 〜 </chapter> の中で include されていることに注意
+
+	$FML: intro.sgml,v 1.3 2001/04/22 12:45:46 fukachan Exp $
+-->
+
+<title>fml5 (仮名) プロジェクトの目的</title>
+  
+<para>
+fml-devel は将来 fml 5.0 になるであろうという… 
+</para>
+
+
+<!-- ========================================================
+		section 1
+     ========================================================
+-->
+
+<sect1>
+
+<title> fml-devel プロジェクトの構想 </title>
+
+
+<para>
+fml-devel とも呼ばれている fml 5.0 プロジェクトは、
+fml 4.0 の再構想(refactoring)とその実装(例)の構築
+を行なっています。
+</PARA>
+
+<para>
+http://www.fml.org/devel/
+は将来の fml-current についてのデザインや実装例を紹介しています。
+</PARA>
+
+
+<para>
+これは fml 5.0 のアイデアを募るための、
+fml 5.0 のアルファ版のアルファ版のアルファ版
+もしくは
+プロトタイプ
+とでもいうべきものです。ですが、すでに動く実装例をダウンロードできます
+し、fml 1.2 相当の機能を使うこともできます。しかしながら、変数名もアー
+キテクチャアも本決まりではないので、将来変わる可能性があります。
+</PARA>
+
+<para>
+また、多くの機能が実装されていません。これは、デザインを最初から考え直
+すに当たり、アイデアや意見を募集するためにまだまだ原型にとどまっている
+ためでもあります。
+</PARA>
+
+<para>
+ものによっては fml 5.0 用に作られたモジュールを fml 4.0 へ
+輸入/輸出することも検討しています。
+たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)などは
+その良い例だろうし、新機能を提供するモジュールなども再輸入(輸出)可能な
+ものは順次マージしていきます。
+</PARA>
+
+<para>
+これらのマージおよび 4.0 自体のコードの保守をしつつ 4.0 および 5.0 は
+並行開発されていく予定です。
+そのため 4.0 系は stable に近い current という位置付けになります。
+そして 4.0 の bug fix は 4.0.x (4.0.1 4.0.2 …)としてまとめられリリー
+スれていく予定です。
+逆に 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/ja/tutorial/reference.sgml b/fml/doc/ja/tutorial/reference.sgml
new file mode 100644
index 00000000..83bbe48c
--- /dev/null
+++ b/fml/doc/ja/tutorial/reference.sgml
@@ -0,0 +1,11 @@
+<!-- 
+	すでに <chapter> 〜 </chapter> の中で include されていることに注意
+
+	$FML: reference.sgml,v 1.2 2001/04/22 16:10:46 fukachan Exp $
+-->
+
+<title>Reference</title>
+
+<sect1 id="terms">
+    &terms;
+</sect1>
diff --git a/fml/doc/ja/tutorial/terms.sgml b/fml/doc/ja/tutorial/terms.sgml
new file mode 100644
index 00000000..e178d731
--- /dev/null
+++ b/fml/doc/ja/tutorial/terms.sgml
@@ -0,0 +1,31 @@
+<!-- 
+	すでに <chapter> 〜 </chapter> の中で include されていることに注意
+
+	$FML: terms.sgml,v 1.2 2001/04/22 16:10:46 fukachan Exp $
+-->
+<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>