make overview/ part and modified to fit it

4 files changed, 37 insertions, 236 deletions

diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index b57822fb..20c72bf2 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,52 +1,50 @@
 <!--
-	$FML: chapters.ent,v 1.1 2001/05/01 14:49:18 fukachan Exp $
+	$FML: chapters.ent,v 1.2 2001/05/01 15:16:26 fukachan Exp $
 -->
 
 <!entity versin "1.1">
 
-<!-- include する SGML ファイル群 -->
-<!entity bookinfo SYSTEM "include/bookinfo.sgml">
-<!entity preface  SYSTEM "preface.sgml">
-<!entity terms     SYSTEM "include/terms.sgml">
-
+<!-- ポインタ -->
+<!entity fmlbible    "『fml バイブル』(オライリージャパン刊)">
+<!entity www.fml.org "http://www.fml.org/fml/">
 
-<!entity available SYSTEM "available.sgml">
-<!entity docbook   SYSTEM "docbook.sgml">
-<!entity download  SYSTEM "download.sgml">
-<!entity install   SYSTEM "install/chapter.sgml">
-<!entity install   SYSTEM "install.sgml">
 
-<!entity fmlcommands SYSTEM "commands.sgml">
-<!entity overview    SYSTEM "overview.sgml">
+<!-- 画像 -->
+<!entity architecture SYSTEM "architecture.gif" ndata gif>
 
 
-<!entity reference       SYSTEM "reference.sgml">
+<!-- メタレベル -->
+<!entity bookinfo SYSTEM "include/bookinfo.sgml">
+<!entity terms    SYSTEM "include/terms.sgml">
+<!entity preface  SYSTEM "preface.sgml">
 
-<!entity delivery         SYSTEM "delivery/chapter.sgml">
-<!entity modules          SYSTEM "modules.sgml">
 
+<!-- overview: introduction 〜 インストール、テストまで -->
+<!entity overview    SYSTEM "overview/chapter.sgml">
+<!entity download    SYSTEM "overview/download.sgml">
+<!entity available   SYSTEM "overview/available.sgml">
+<!entity install     SYSTEM "install/chapter.sgml">
 
-<!entity appendix SYSTEM "appendix.sgml">
-<!entity glossary SYSTEM "glossary.sgml">
-<!entity cvstree  SYSTEM "devel/cvstree.sgml">
-<!entity cvstags  SYSTEM "devel/cvstags.sgml">
 
+<!-- う〜ん、分類は…？;-) -->
+<!entity fmlcommands SYSTEM "commands.sgml">
+<!entity modules     SYSTEM "modules.sgml">
 
 
-<!-- ポインタ -->
-<!entity fmlbible    "『fml バイブル』(オライリージャパン刊)">
-<!entity www.fml.org "http://www.fml.org/fml/">
+<!-- 内部構造 -->
+<!entity chapter.bootloader      SYSTEM "internals/bootloader.sgml">
+<!entity sect.main.cf            SYSTEM "internals/main.cf.sgml">
+<!entity chapter.programingstyle SYSTEM "internals/style.sgml">
+<!entity design                  SYSTEM "internals/design.sgml">
 
 
-<!-- 画像 -->
-<!entity architecture SYSTEM "architecture.gif" ndata gif>
+<!-- 配送 -->
+<!entity delivery  SYSTEM "delivery/chapter.sgml">
 
 
-<!-- 内部構造 -->
-<!entity chapter.bootloader   SYSTEM "internals/bootloader.sgml">
-<!entity sect.main.cf         SYSTEM "internals/main.cf.sgml">
-<!entity chapter.programingstyle SYSTEM "internals/style.sgml">
-<!entity design          SYSTEM "internals/design.sgml">
+<!-- 開発 -->
+<!entity cvstree   SYSTEM "devel/cvstree.sgml">
+<!entity cvstags   SYSTEM "devel/cvstags.sgml">
 
 
 <!-- プログラムの説明 -->
@@ -55,3 +53,10 @@
 <!entity sect.fmldoc      SYSTEM "programs/fmldoc.sgml">
 <!entity sect.fmlticket   SYSTEM "programs/fmlticket.sgml">
 <!entity sect.makefml     SYSTEM "programs/makefml.sgml">
+
+
+<!-- Appendix -->
+<!entity reference SYSTEM "reference.sgml">
+<!entity appendix  SYSTEM "appendix.sgml">
+<!entity glossary  SYSTEM "glossary.sgml">
+<!entity docbook   SYSTEM "docbook.sgml">
diff --git a/fml/doc/ja/tutorial/overview.sgml b/fml/doc/ja/tutorial/overview.sgml
deleted file mode 100644
index 996474c3..00000000
--- a/fml/doc/ja/tutorial/overview.sgml
+++ /dev/null
@@ -1,204 +0,0 @@
-<!--
-	$FML$
--->
-
-<chapter id="overview"> 
-<title> おおまかな流れ </title>
-
-<sect1>
-	<title> 概要 </title>
-
-<warning>
-<para>
-fml-devel 
-は動くとはいえ、まだまだ開発者向けのプログラムであることに注意して
-下さい。実運用には 
-	<ulink url="http://www.fml.org/fml/">
-	fml 4.0
-	</ulink>
-系を御利用下さい。
-</para>
-</warning>
-
-
-<para>
-以下で、特に触れていない概念(例: ＭＬとは？)については fml 4.0 と同様
-です。4.0 の資料を適宜参照して下さい。
-</para>
-
-<para>
-いつものように elena ＭＬを例にとりましょう。
-elena ＭＬを作成するまでのおおまかな流れは次のようになります。
-</para>
-
-
-<orderedlist>
-   <listitem>
-	<para>
-		<link linkend="download">
-		ソースをダウンロードをする。
-		</link>
-	</para>
-   </listitem>
-
-   <listitem>
-	<para>
-		<link linkend="install">
-		ユーザ root でインストールをする。
-		</link>
-
-		インストーラは /usr/local/bin に 
-			fmldoc fmlconf fmlticket makefml 
-		をインストールします。
-
-		これらは、
-		実は、
-		/usr/local/libexec/fml の下の実体を呼び出す単なる
-		wrapper です。
-
-	なお、インストールされるコマンドの一覧は
-		<link linkend="available">
-		ここ
-		</link>
-	にあります。
-	</para>
-   </listitem>
-
-
-   <listitem>
-	<para>
-		<link linkend="guide.newml">
-		ユーザ fml で elena ＭＬを作る。 
-		</link>
-	</para>
-   </listitem>
-
-
-   <listitem>
-	<para>
-		<link linkend="guide.config.cf">
-		カスタマイズをする。 
-		</link>
-	</para>
-   </listitem>
-
-</orderedlist>
-
-</sect1>
-
-
-
-
-<sect1 id="guide.newml">
-
-   <title> ＭＬを作る </title>
-
-<para>
-fml 4.0 と同様です。 
-が、config.cf という設定ファイルをインストールしてくれるだけです。
-
-インストール後は、次のようになるはずです。
-<screen>
-% su fml
-% makefml newml elena
-% ls /var/spool/ml/elena
-config.cf
-</screen>
-</para>
-
-
-<para>
-とりあえず config.cf の先頭の ml_domain と ml_name を
-自分のＭＬに変更して下さい。
-まだ自動変換できません（そのうちします）。
-</para>
-
-
-<para>
-<screen>
-config.cf の例
-
-# ドメイン名 (参照: 以下のアドレスを見よ $ml_domain がこの値に展開される)
-ml_domain           = fml.org
-
-# ML の名前
-ml_name		    = elena		
-
-# 管理者のアドレス
-maintainer	    = $ml_name-admin@$ml_domain
-
-# 投稿用のアドレス
-address_for_post    = $ml_name@$ml_domain
-
-# コマンド用のアドレス
-address_for_command = $ml_name-ctl@$ml_domain
-</screen>
-</para>
-
-
-<para>
-include include-ctl aliases も fml 4.0 と同様です。
-が、まだ、makefml newml で自動生成できるようになっていません _o_
-</para>
-
-<para>
-/var/spool/ml/elena/include ファイルは
-<screen>
-"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena"
-</screen>
-
-/var/spool/ml/elena/include-ctl ファイルは
-<screen>
-"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr"
-</screen>
-</para>
-
-
-<para>
-aliases への追加は次のようにして下さい。
-<screen>
-elena: :include:/var/spool/ml/elena/include
-elena-ctl: :include:/var/spool/ml/elena/include-ctl
-elena-admin: fml
-owner-elena: fml
-owner-elena-ctl: fml
-</screen>
-</para>
-
-</sect1>
-
-
-
-<sect1 id="guide.config.cf">
-
-<title> カスタマイズをする </title>
-
-<para>
-elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集
-して下さい。フォーマットは fml 4.0 の cf に近いですが、postfix の設定
-ファイルと同様です。
-</para>
-
-<para>
-必要な項目を追加して下さい。それ以外はデフォルト値が使われます。
-デフォルト値はインストールしたバージョンに依存し、
-
-<screen>
-/etc/fml/defaults/バージョン番号/default_config.cf
-</screen>
-
-というファイルで定義されています。
-
-これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように
-バージョン番号付のディレクトリに置かれるのと同様です。
-</para>
-
-<para>
-インストールした fml のバージョンごとに全部別のディレクトリに
-置かれることに注意して下さい。
-この仕組みのおかげでアップグレードしても元に戻すのが簡単です。
-</para>
-
-</sect1>
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/available.sgml b/fml/doc/ja/tutorial/overview/available.sgml
index 1b554aed..34c041ec 100644
--- a/fml/doc/ja/tutorial/available.sgml
+++ b/fml/doc/ja/tutorial/overview/available.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML$
+	$FML: available.sgml,v 1.1 2001/04/25 03:54:02 fukachan Exp $
 -->
 
 <chapter id="available">
diff --git a/fml/doc/ja/tutorial/download.sgml b/fml/doc/ja/tutorial/overview/download.sgml
index 993a2f0f..aa92e88a 100644
--- a/fml/doc/ja/tutorial/download.sgml
+++ b/fml/doc/ja/tutorial/overview/download.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML$
+	$FML: download.sgml,v 1.1 2001/04/24 10:06:36 fukachan Exp $
 -->
 
 <chapter id="download">