reorder, enrich part II

24 files changed, 271 insertions, 196 deletions

diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 5a185964..ce2943f4 100644
--- a/fml/doc/ja/tutorial/book.sgml
+++ b/fml/doc/ja/tutorial/book.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: book.sgml,v 1.19 2001/11/19 14:55:15 fukachan Exp $
+$FML: book.sgml,v 1.20 2001/11/23 15:00:46 fukachan Exp $
 -->
 
 <!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -41,11 +41,6 @@ $FML: book.sgml,v 1.19 2001/11/19 14:55:15 fukachan Exp $
   </part>
 
 
-	<!--
-	&chapter.available;
-	は第 2 部に移して、分離するべきかな？
-	-->
-
   <part>
 	<title> 各論およびカスタマイズ </title>
 	<partintro>
@@ -54,8 +49,12 @@ $FML: book.sgml,v 1.19 2001/11/19 14:55:15 fukachan Exp $
 	</para>
 	</partintro>
 
-	&chapter.available;
-	&chapter.programs;
+	&chapter.usage.post;
+	&chapter.usage.command;
+	&chapter.usage.onhost;
+
+	<!-- スレッド追跡システム -->
+	&chapter.threadtrack.usage;
   </part>
 
 
@@ -84,10 +83,6 @@ $FML: book.sgml,v 1.19 2001/11/19 14:55:15 fukachan Exp $
 	<!-- 記事の配送とコマンドの処理 -->
         &chapter.delivery;
         &chapter.replybyfml;
-	&chapter.fmlcommand;
-
-	<!-- スレッド追跡システム -->
-	&chapter.threadtrack.usage;
   </part>
 
 
@@ -101,11 +96,12 @@ $FML: book.sgml,v 1.19 2001/11/19 14:55:15 fukachan Exp $
 
 	&chapter.module.io.adapter;
 	&chapter.module.mail.message;
+	&chapter.module.nl;
   </part>
 
 
   <!-- 
-	***** ここから後は付録 *****
+	*************** ここから後は付録 **************
   -->
   <part>
 	<title> 付録 </title>
diff --git a/fml/doc/ja/tutorial/command/extension.sgml b/fml/doc/ja/tutorial/command/extension.sgml
index 7a287745..a3331249 100644
--- a/fml/doc/ja/tutorial/command/extension.sgml
+++ b/fml/doc/ja/tutorial/command/extension.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML$
+   $FML: extension.sgml,v 1.1 2001/10/13 08:47:54 fukachan Exp $
 -->
 
 
 <sect1 id="fml.command.hack.example0">
-   <title> コマンドの拡張の仕方の例 </title>
+   <title> コマンドの拡張の仕方 (予定) </title>
 
 
    <sect2>
diff --git a/fml/doc/ja/tutorial/command/internal.sgml b/fml/doc/ja/tutorial/command/internal.sgml
index 0bfa8974..7cccd856 100644
--- a/fml/doc/ja/tutorial/command/internal.sgml
+++ b/fml/doc/ja/tutorial/command/internal.sgml
@@ -1,10 +1,10 @@
 <!--
-   $FML$
+   $FML: internal.sgml,v 1.1.1.1 2001/10/12 11:00:20 fukachan Exp $
 -->
 
-<sect1 id="fml.command.overview">
+<sect1 id="fml.command.interal.change">
 	<title>
-	コマンド処理の概要:
+	議論:
 	『4.0 と 5.0 のコードの書き方はどのくらい違うか？』 
 	</title>
 
diff --git a/fml/doc/ja/tutorial/command/chapter.sgml b/fml/doc/ja/tutorial/command/module.sgml
index 41e161f4..fd0fdd24 100644
--- a/fml/doc/ja/tutorial/command/chapter.sgml
+++ b/fml/doc/ja/tutorial/command/module.sgml
@@ -1,43 +1,30 @@
 <!--
-	$FML: chapter.sgml,v 1.2 2001/10/12 11:14:19 fukachan Exp $
+   $FML$
 -->
 
-<chapter id="fml.command.op">
+
+<sect1 id="fml.command.module.hierarchy">
 	<title>
-	コマンド: fml をメールで操作する
+	コマンドが使うモジュール
 	</title>
 
 <para>
-fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
-もらうことができます。例えば、メンバーの登録、削除や、過去の記事を取り
-寄せるなどの処理です。
+5.0 では、
+コマンドメール、makefml そして CGI が使うモジュール
+は共有されています。
+ただし、その権限の差異によって、
+ユーザ用のモジュールと管理者用のモジュールの2つに分かれています。
+以下、これらのモジュール群の構成について解説します。
 </para>
 
 <para>
-fml 5.0  では
-<screen>
-メールによるコマンド処理
-makefml によるコマンド処理
-CGI でのコマンド処理
-</screen>
-これらすべての機能が FML::Command:: クラスのモジュールを使うように
-設計されています。
-</para>
-
-
-<sect1 id="fml.command.module.hierarchy">
-	<title>
-	FML::Command クラス以下の構成
-	</title>
-
-<para>
 FML::Command:: クラスは以下のような構成になっています。
 <screen>
 FML::Command.pm		FML::Command クラス以下への入口
 FML::Command::ACL	ACL
 FML::Command::Utils	よもやまの定義
 FML::Command::User	ユーザ用コマンド群
-FML::Command::Admin	ユーザ用コマンド群
+FML::Command::Admin	管理者用コマンド群
 </screen>
 例えば、(メールでの)ユーザ用のコマンドの場合
 FML::Command.pm を経由して
@@ -104,14 +91,3 @@ FML::Command::Admin::コマンド.pm
 
 
 </sect1>
-
-
-<!-- コマンドの例 -->
-&sect.command.internal;
-
-
-<!-- コマンドの拡張例 -->
-&sect.command.extension;
-
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 41a1a8cc..9c0cd625 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapters.ent,v 1.19 2001/10/22 11:08:05 fukachan Exp $
+	$FML: chapters.ent,v 1.20 2001/11/19 14:55:16 fukachan Exp $
 -->
 
 <!entity versin "1.1">
@@ -21,27 +21,36 @@
 <!entity sect.terms SYSTEM "include/terms.sgml">
 
 
-<!-- overview: introduction 〜 インストール、テストまで -->
-<!entity chapter.overview    SYSTEM "overview/chapter.sgml">
-<!entity chapter.download    SYSTEM "overview/download.sgml">
-<!entity chapter.available   SYSTEM "overview/available.sgml">
-<!entity chapter.install     SYSTEM "install/chapter.sgml">
+<!-- パート I: introduction 〜 インストール、テストまで -->
+<!entity chapter.overview        SYSTEM "overview/chapter.sgml">
+<!entity chapter.download        SYSTEM "overview/download.sgml">
+<!entity chapter.install         SYSTEM "install/chapter.sgml">
+
+
+<!-- パート II: 使い方の例とカスタマイズについて -->
+<!entity chapter.usage.post      SYSTEM "usage/post.sgml">
+<!entity chapter.usage.command   SYSTEM "usage/command.sgml">
+<!entity chapter.usage.onhost    SYSTEM "usage/onhost.sgml">
+<!entity sect.usage.makefml      SYSTEM "usage/makefml.sgml">
+<!entity sect.usage.fmlconf      SYSTEM "usage/fmlconf.sgml">
+<!entity sect.usage.fmldoc       SYSTEM "usage/fmldoc.sgml">
+<!entity sect.usage.fmlthread    SYSTEM "usage/fmlthread.sgml">
+<!entity sect.usage.fmlhtmlify   SYSTEM "usage/fmlhtmlify.sgml">
 
 
 <!-- コマンド -->
-<!entity chapter.fmlcommand     SYSTEM "command/chapter.sgml">
-<!entity sect.command.internal  SYSTEM "command/internal.sgml">
-<!entity sect.command.extension SYSTEM "command/extension.sgml">
+<!entity sect.command.internal   SYSTEM "command/internal.sgml">
+<!entity sect.command.extension  SYSTEM "command/extension.sgml">
+<!entity sect.command.module     SYSTEM "command/module.sgml">
 
 
 <!-- う〜ん、分類は…？;-) -->
-<!entity chapter.db          SYSTEM "internals/db.sgml">
-<!entity chapter.dbms        SYSTEM "internals/dbms.sgml">
+<!entity chapter.db              SYSTEM "internals/db.sgml">
+<!entity chapter.dbms            SYSTEM "internals/dbms.sgml">
 
 
 <!-- 配送 -->
-<!entity chapter.delivery   SYSTEM "delivery/chapter.sgml">
-<!entity chapter.replybyfml SYSTEM "delivery/reply.sgml">
+<!entity chapter.delivery        SYSTEM "delivery/chapter.sgml">
 
 
 <!-- 内部構造 -->
@@ -50,38 +59,31 @@
 <!entity chapter.programingstyle SYSTEM "internals/style.sgml">
 <!entity chapter.design          SYSTEM "internals/design.sgml">
 <!entity chapter.config.cf       SYSTEM "internals/config.cf.sgml">
-<!entity chapter.message         SYSTEM "internals/message.sgml">
-<!entity chapter.nl              SYSTEM "internals/nativelanguage.sgml">
+
+
+<!-- メッセージの取り扱い -->
+<!entity chapter.message         SYSTEM "message/chapter.sgml">
 <!entity chapter.message.nl      SYSTEM "message/language.sgml">
+<!entity chapter.replybyfml      SYSTEM "message/reply.sgml">
 
 
 <!-- 開発 -->
-<!entity chapter.cvstree SYSTEM "devel/cvstree.sgml">
-<!entity chapter.cvstags SYSTEM "devel/cvstags.sgml">
-<!entity chapter.docbook SYSTEM "devel/docbook.sgml">
-<!entity chapter.inet6   SYSTEM "devel/inet6.sgml">
+<!entity chapter.cvstree         SYSTEM "devel/cvstree.sgml">
+<!entity chapter.cvstags         SYSTEM "devel/cvstags.sgml">
+<!entity chapter.docbook         SYSTEM "devel/docbook.sgml">
+<!entity chapter.inet6           SYSTEM "devel/inet6.sgml">
 
 
 <!-- misc -->
-<!entity chapter.ticket.usage		SYSTEM "ticketsystem/chapter.sgml">
-<!entity chapter.ticket.tools		SYSTEM "ticketsystem/tools.sgml">
 <!entity chapter.threadtrack.usage	SYSTEM "threadtrack/chapter.sgml">
 <!entity chapter.threadtrack.tools	SYSTEM "threadtrack/tools.sgml">
 
 
-<!-- プログラムの説明 -->
-<!entity chapter.programs SYSTEM "programs/chapter.sgml">
-<!entity sect.fmlconf     SYSTEM "programs/fmlconf.sgml">
-<!entity sect.fmldoc      SYSTEM "programs/fmldoc.sgml">
-<!entity sect.fmlticket   SYSTEM "programs/fmlticket.sgml">
-<!entity sect.fmlthread   SYSTEM "programs/fmlthread.sgml">
-<!entity sect.makefml     SYSTEM "programs/makefml.sgml">
-
-
 <!-- Appendix -->
-<!entity chapter.glossary SYSTEM "glossary.sgml">
+<!entity chapter.glossary         SYSTEM "glossary.sgml">
 
 
 <!-- modules -->
 <!entity chapter.module.io.adapter   SYSTEM "module/IO::Adapter.sgml">
 <!entity chapter.module.mail.message SYSTEM "module/Mail::Message.sgml">
+<!entity chapter.module.nl           SYSTEM "module/nativelanguage.sgml">
diff --git a/fml/doc/ja/tutorial/internals/message.sgml b/fml/doc/ja/tutorial/message/chapter.sgml
index 495c9c3d..86de2a7a 100644
--- a/fml/doc/ja/tutorial/internals/message.sgml
+++ b/fml/doc/ja/tutorial/message/chapter.sgml
@@ -1,9 +1,9 @@
 <!--
-	$FML: message.sgml,v 1.6 2001/09/30 23:09:39 fukachan Exp $	
+	$FML: message.sgml,v 1.7 2001/10/13 08:47:57 fukachan Exp $	
 -->
 
 <chapter id="mail.manipulation">
-   <title> メールの操作 </title>
+   <title> メッセージ(メール)の操作 </title>
 
 <para>
 メール(オブジェクト)を扱う関数の詳細については
diff --git a/fml/doc/ja/tutorial/delivery/reply.sgml b/fml/doc/ja/tutorial/message/reply.sgml
index 697d6b19..5bfd8611 100644
--- a/fml/doc/ja/tutorial/delivery/reply.sgml
+++ b/fml/doc/ja/tutorial/message/reply.sgml
@@ -1,5 +1,5 @@
 <!--
-    $FML: reply.sgml,v 1.3 2001/08/26 05:55:52 fukachan Exp $
+    $FML: reply.sgml,v 1.4 2001/10/13 08:47:55 fukachan Exp $
 -->
 
 <chapter id="message.reply">
diff --git a/fml/doc/ja/tutorial/module/IO::Adapter.sgml b/fml/doc/ja/tutorial/module/IO::Adapter.sgml
index afa03c9d..489739d1 100644
--- a/fml/doc/ja/tutorial/module/IO::Adapter.sgml
+++ b/fml/doc/ja/tutorial/module/IO::Adapter.sgml
@@ -1,8 +1,8 @@
 <!--
-   $FML: ioadapter.sgml,v 1.1 2001/09/17 13:04:25 fukachan Exp $
+   $FML: IO::Adapter.sgml,v 1.1 2001/09/30 23:08:59 fukachan Exp $
 -->
 
-<chapter id="io.adapter">
+<chapter id="module.io.adapter">
 	<title>
 	IO::Adapter
 	</title>
diff --git a/fml/doc/ja/tutorial/internals/nativelanguage.sgml b/fml/doc/ja/tutorial/module/nativelanguage.sgml
index dbaf3a63..fddd7ff5 100644
--- a/fml/doc/ja/tutorial/internals/nativelanguage.sgml
+++ b/fml/doc/ja/tutorial/module/nativelanguage.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: nativelanguage.sgml,v 1.3 2001/08/05 12:39:13 fukachan Exp $
+   $FML: nativelanguage.sgml,v 1.4 2001/10/13 08:47:57 fukachan Exp $
 -->
 
 <chapter>
diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml
index 2b3bdaf4..1f059e76 100644
--- a/fml/doc/ja/tutorial/overview/chapter.sgml
+++ b/fml/doc/ja/tutorial/overview/chapter.sgml
@@ -1,5 +1,5 @@
 <!--
-	$FML: chapter.sgml,v 1.4 2001/11/19 14:55:16 fukachan Exp $
+	$FML: chapter.sgml,v 1.5 2001/11/23 15:00:48 fukachan Exp $
 -->
 
 <chapter id="overview"> 
@@ -51,9 +51,7 @@
 
 	<para>
 		(デフォルトでは)インストーラは /usr/local/bin に 
-		<link linkend="available">
 		fmldoc fmlconf fmlthread makefml fmlhtmlify fmlsch
-		</link>
 		などをインストールします。
 	</para>
 
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
index 48d99208..f9d1db9a 100644
--- a/fml/doc/ja/tutorial/preface.sgml
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: preface.sgml,v 1.10 2001/11/19 14:55:15 fukachan Exp $
+   $FML: preface.sgml,v 1.11 2001/11/23 15:00:46 fukachan Exp $
 -->
 
 
@@ -267,7 +267,7 @@ fml 5.0 用に作られたモジュールを fml 4.0 へ輸入する予定です。
 
     <listitem>
 	<para>
-	<link linkend="io.adapter">
+	<link linkend="module.io.adapter">
 	抽象化 IO 層
 	</link>
 	メンバーファイルをファイル、/etc/group, NIS, MySQL 
@@ -275,12 +275,6 @@ fml 5.0 用に作られたモジュールを fml 4.0 へ輸入する予定です。
 	</para>
     </listitem>
     </itemizedlist>
-
-詳細は
-<link linkend="available"> 
-『&fml5; の実行形式プログラム』の章
-</link>
-を参照して下さい。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/programs/chapter.sgml b/fml/doc/ja/tutorial/programs/chapter.sgml
deleted file mode 100644
index ea5a6535..00000000
--- a/fml/doc/ja/tutorial/programs/chapter.sgml
+++ /dev/null
@@ -1,14 +0,0 @@
-<!--
-	$FML: programs.sgml,v 1.1 2001/04/26 11:02:39 fukachan Exp $
--->
-
-<chapter id="programs">
-
-<title>	プログラム </title>
-
-&sect.fmlconf;
-&sect.fmldoc;
-<!-- &sect.fmlticket; -->
-&sect.makefml;
-
-</chapter>
diff --git a/fml/doc/ja/tutorial/programs/fmlconf.sgml b/fml/doc/ja/tutorial/programs/fmlconf.sgml
deleted file mode 100644
index 72b57200..00000000
--- a/fml/doc/ja/tutorial/programs/fmlconf.sgml
+++ /dev/null
@@ -1,21 +0,0 @@
-<!--
-	$FML: fmlconf.sgml,v 1.1.1.1 2001/04/26 08:33:58 fukachan Exp $
--->
-
-<sect1 id="fmlconf">
-
-<title> fmlconf (/usr/local/bin/fmlconf) </title>
-
-<para>
-
-fmlconf は引数にＭＬ名をとり、そのＭＬの変数一覧を表示します。
--n をつけるとデフォルトと異なる変数のみを表示します。
-
-<screen>
-% fmlconf elena
-% fmlconf -n elena
-</screen>
-
-</para>
-
-</sect1>
diff --git a/fml/doc/ja/tutorial/programs/fmldoc.sgml b/fml/doc/ja/tutorial/programs/fmldoc.sgml
deleted file mode 100644
index 3586ab1a..00000000
--- a/fml/doc/ja/tutorial/programs/fmldoc.sgml
+++ /dev/null
@@ -1,20 +0,0 @@
-<!--
-	$FML: fmldoc.sgml,v 1.1.1.1 2001/04/26 08:33:58 fukachan Exp $
--->
-
-<sect1 id="fmldoc">
-
-<title> fmldoc (/usr/local/bin/fmldoc) </title>
-
-<para>
-fmldoc の使い方は perldoc と同様です。fml の任意のモジュールに対しその
-ドキュメントを表示します。
-実のところ perldoc への wrapper です。
-
-<screen>
-% fmldoc FML::Process::Kernel
-</screen>
-
-</para>
-
-</sect1>
diff --git a/fml/doc/ja/tutorial/programs/fmlticket.sgml b/fml/doc/ja/tutorial/programs/fmlticket.sgml
deleted file mode 100644
index 1a26f682..00000000
--- a/fml/doc/ja/tutorial/programs/fmlticket.sgml
+++ /dev/null
@@ -1,27 +0,0 @@
-<!--
-	$FML: fmlticket.sgml,v 1.1.1.1 2001/04/26 08:33:58 fukachan Exp $
--->
-
-<sect1 id="fmlticket">
-
-<title> fmlticket (/usr/local/bin/fmlticket) </title>
-
-<para>
-
-fmlticket は引数にコマンドとＭＬ名をとります。
-チケットシステムへのインターフェイスです。
-まだ製作途中です。
-
-close されていないチケット一覧を表示
-<screen>
-% fmlticket list elena
-</screen>
-
-チケットを close する。
-<screen>
-% fmlticket close elena チケット番号
-</screen>
-
-</para>
-
-</sect1>
diff --git a/fml/doc/ja/tutorial/overview/available.sgml b/fml/doc/ja/tutorial/usage/TODO
index 9cb3d56f..465ef148 100644
--- a/fml/doc/ja/tutorial/overview/available.sgml
+++ b/fml/doc/ja/tutorial/usage/TODO
@@ -1,5 +1,5 @@
 <!--
-   $FML: available.sgml,v 1.2 2001/10/13 08:47:57 fukachan Exp $
+   $FML: available.sgml,v 1.3 2001/11/23 15:00:47 fukachan Exp $
 -->
 
 <chapter id="available">
diff --git a/fml/doc/ja/tutorial/usage/command.sgml b/fml/doc/ja/tutorial/usage/command.sgml
new file mode 100644
index 00000000..dc52c359
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/command.sgml
@@ -0,0 +1,66 @@
+<!--
+	$FML: chapter.sgml,v 1.3 2001/10/13 08:47:54 fukachan Exp $
+-->
+
+<chapter id="fml.command.bymail">
+	<title>
+	コマンドメール (fml をメールで操作する)
+	</title>
+
+<para>
+fml にメールで文字列(コマンド)を送り込むことで、fml に特定の処理をして
+もらうことができます。例えば、メンバーの登録、削除や、過去の記事を取り
+寄せるなどの処理です。
+</para>
+
+
+<para>
+fml 5.0  では
+<screen>
+メールによるコマンド処理
+makefml によるコマンド処理
+CGI でのコマンド処理
+</screen>
+これらすべての機能が FML::Command:: クラスのモジュールを使うように
+設計されています。
+</para>
+
+
+<sect1 id="fml.command.bymail.flow">
+	<title>
+	処理の流れ
+	</title>
+
+<para>
+elena ＭＬの場合、
+コマンドメールを elena-ctl@fml.org に送信してください。
+メールは MTA が受け、最終的に MTA は
+/usr/local/libexec/fml/fml.pl --ctladdr
+(もしくは /usr/local/libexec/fml/command )
+というコマンドを実行します。
+fml.pl はメールを標準入力から受けとり、
+ＭＬとして必要な処理をした後、MTA へ配送を委ねます。
+</para>
+
+<warning>
+<para>
+4.0 と違い、5.0 ではコマンドの結果を
+<link linkend="message.reply">
+一通のメール ( MIME/Multipart )にまとめて返送
+</link>
+しています。
+</para>
+</warning>
+
+</sect1>
+
+
+<!-- モジュールの使い方について、 FML::Command:: 以下の話 -->
+&sect.command.module;
+
+<!-- コマンドの拡張例 -->
+&sect.command.extension;
+
+&sect.command.internal;
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/usage/fmlconf.sgml b/fml/doc/ja/tutorial/usage/fmlconf.sgml
new file mode 100644
index 00000000..eda23ec0
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/fmlconf.sgml
@@ -0,0 +1,21 @@
+<!--
+	$FML: fmlconf.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+-->
+
+<sect1 id="usage.fmlconf">
+
+<title> 設定を表示する (fmlconf) </title>
+
+<para>
+fmlconf (/usr/local/bin/fmlconf) 
+は引数にＭＬ名をとり、そのＭＬの変数一覧を表示します。
+-n をつけるとデフォルトと異なる変数のみを表示します。
+
+<screen>
+% fmlconf elena
+% fmlconf -n elena
+</screen>
+
+</para>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/usage/fmldoc.sgml b/fml/doc/ja/tutorial/usage/fmldoc.sgml
new file mode 100644
index 00000000..302fbef2
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/fmldoc.sgml
@@ -0,0 +1,22 @@
+<!--
+	$FML: fmldoc.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+-->
+
+<sect1 id="usage.fmldoc">
+
+<title> モジュールのドキュメントを表示する (fmldoc) </title>
+
+<para>
+fmldoc の使い方は perldoc と同様です。
+fml の任意のモジュールに対し、そのドキュメントを表示します。
+実のところ perldoc への wrapper です。
+</para>
+
+<para>
+例えば、FML::Process::Kernel のドキュメントが見たい場合、
+<screen>
+% fmldoc FML::Process::Kernel
+</screen>
+</para>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
new file mode 100644
index 00000000..fe5bcdef
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/fmlhtmlify.sgml
@@ -0,0 +1,16 @@
+<!--
+	$FML: fmlhtmlify.sgml,v 1.2 2001/04/26 11:02:39 fukachan Exp $
+-->
+
+<sect1 id="usage.fmlhtmlify">
+
+<title> 記事を HTML 化する (fmlhtmlify) </title>
+
+<para>
+<screen>
+% fmlhtmlify ＭＬ名
+</screen>
+
+</para>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/usage/fmlthread.sgml b/fml/doc/ja/tutorial/usage/fmlthread.sgml
new file mode 100644
index 00000000..0421b84f
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/fmlthread.sgml
@@ -0,0 +1,25 @@
+<!--
+	$FML: fmlthread.sgml,v 1.2 2001/04/26 11:02:40 fukachan Exp $
+-->
+
+<sect1 id="usage.fmlthread">
+
+<title> スレッドを表示する (fmlthread) </title>
+
+<para>
+fmlthread は引数にコマンドとＭＬ名をとります。
+疑似チケットシステムへのインターフェイスです。
+
+close されていないチケット一覧を表示
+<screen>
+% fmlthread list elena
+</screen>
+
+チケットを close する。
+<screen>
+% fmlthread close elena チケット番号
+</screen>
+
+</para>
+
+</sect1>
diff --git a/fml/doc/ja/tutorial/programs/makefml.sgml b/fml/doc/ja/tutorial/usage/makefml.sgml
index 46b18f87..aa5e2c55 100644
--- a/fml/doc/ja/tutorial/programs/makefml.sgml
+++ b/fml/doc/ja/tutorial/usage/makefml.sgml
@@ -1,10 +1,10 @@
 <!--
-	$FML: makefml.sgml,v 1.3 2001/09/13 13:29:00 fukachan Exp $
+   $FML: makefml.sgml,v 1.4 2001/10/13 08:47:58 fukachan Exp $
 -->
 
-<sect1 id="makefml">
+<sect1 id="usage.makefml">
 
-<title> makefml (/usr/local/bin/makefml) </title>
+<title> makefml を使って、ユーザの登録/削除他(あらゆる:) </title>
 
 <para>
 makefml の基本的な使い方は fml 4.0 の makefml と同様です。
@@ -64,11 +64,6 @@ makefml の基本的な使い方は fml 4.0 の makefml と同様です。
 	</listitem>
 
 </itemizedlist>
-コマンドについては詳しくは 
-<link linkend="fml.command.op">
-コマンド
-</link>
-の章を参照して下さい。
 </para>
 
 </sect1>
diff --git a/fml/doc/ja/tutorial/usage/onhost.sgml b/fml/doc/ja/tutorial/usage/onhost.sgml
new file mode 100644
index 00000000..fe6e9d20
--- /dev/null
+++ b/fml/doc/ja/tutorial/usage/onhost.sgml
@@ -0,0 +1,46 @@
+<!--
+	$FML: makefml.sgml,v 1.4 2001/10/13 08:47:58 fukachan Exp $
+-->
+
+<chapter id="usage.onhost">
+	<title>
+	ＭＬ管理者にできること (ＭＬサーバのホスト上)
+	</title>
+
+
+<sect1>
+	<title>
+	ホスト上でできること
+	</title>
+
+<para>
+ＭＬサーバのホストに入ることができる(例: slogin してシェルが取れる)
+人は、通常ＭＬにとって最強の人を意味します。
+</para>
+
+<para>
+ファイルを直接編集することで、どんなことでもできるわけですから、
+無敵です。
+</para>
+
+<para>
+しかしながら、人間間違いを犯すもので、ついフォーマットを
+間違えるといったことがあります。
+</para>
+
+<para>
+そのため、通常は makefml ( /usr/local/bin/makefml )を
+使うことで、fml を操作して下さい。
+</para>
+
+</sect1>
+
+
+&sect.usage.makefml;
+&sect.usage.fmlconf;
+&sect.usage.fmldoc;
+&sect.usage.fmlthread;
+&sect.usage.fmlhtmlify;
+
+
+</chapter>
diff --git a/fml/doc/ja/tutorial/usage/post.sgml b/fml/doc/ja/tutorial/usage/post.sgml
index 4783a1f7..c5b784df 100644
--- a/fml/doc/ja/tutorial/usage/post.sgml
+++ b/fml/doc/ja/tutorial/usage/post.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: bootloader.sgml,v 1.2 2001/05/10 03:11:43 fukachan Exp $
+   $FML: post.sgml,v 1.1.1.1 2001/11/23 15:47:37 fukachan Exp $
 -->
 
 <chapter id="usage.post">
@@ -20,7 +20,7 @@ fml.pl はメールを標準入力から受けとり、
 
 <sect1>
 	<title>
-	ＭＬとして処理するべきこと
+	fml.pl が ＭＬとして処理するべきこと
 	</title>
 
 
@@ -29,7 +29,7 @@ subject のタグをつける、もしくは記事番号などを更新するなど
 <screen>
 Subject: [elena:00100] えれなさん素敵
 </screen>
- (デフォルトではつけません)
+(デフォルトではつけません)
 </para>
 
 <para>
@@ -54,7 +54,7 @@ Subject: [elena:00100] えれなさん素敵
 
 
 <sect1>
-   <title> 備考: ブートしていく様子 </title>
+   <title> 解説: ブートしていく様子 </title>
 
 <para>
 <link linkend="bootloader">