fix description to catch up current implementation.

fix variable names to current ones.
clean up.

1 files changed, 95 insertions, 39 deletions

diff --git a/fml/doc/ja/tutorial/overview/fml.sgml b/fml/doc/ja/tutorial/overview/fml.sgml
index 688cab02..3ad0ade1 100644
--- a/fml/doc/ja/tutorial/overview/fml.sgml
+++ b/fml/doc/ja/tutorial/overview/fml.sgml
@@ -1,5 +1,5 @@
 <!--
-   $FML: fml.sgml,v 1.3 2002/07/07 01:57:12 fukachan Exp $
+   $FML: fml.sgml,v 1.4 2003/04/15 14:51:43 fukachan Exp $
 -->
 
 <chapter id="overview.fml">
@@ -8,6 +8,15 @@
 	</title>
 
 
+<para>
+なお、fml4 と fml8 の相違点についての詳細は、
+<link linkend="changes">
+<xref linkend="changes">
+</link>
+を参照して下さい。
+</para>
+
+
 <!-- ======================================================== -->
 <sect1 id="overview.fml8">
 	<title>
@@ -15,8 +24,8 @@
 	</title>
 
 <para>
-&fml4; の再実装にあたっての山場はすでに越えたと思います。
-でも、こまごまとしたものはいろいろと残っていますが…
+&fml4; の再実装にあたっての山場は越えたと思います。
+あとは、こまごま、いろいろです。
 </para>
 
 <para>
@@ -26,14 +35,21 @@
     <listitem>
 	<para>
 	設定ファイル形式が新しくなりました。
-	今度は postfix 風の設定ファイルです。
+	今度は
+	<link linkend="internal.config.cf">
+	postfix 風の設定ファイル
+	</link>
+	です。
 	</para>
     </listitem>
 
 
     <listitem>
 	<para>
-	makefml によるコマンド操作は &fml4; と同様です:
+	<link linkend="usage.onhost">
+	makefml によるコマンド操作
+	</link>
+	は &fml4; と同様です:
 		ＭＬの作成/削除、
 		メンバーの登録/削除/変更(chaddr)、
 		リモート管理者の登録/削除、
@@ -41,11 +57,19 @@
 		メンバーリストを見る、
 		他。		
 	</para>
+
+	<para>
+	CUI の使い方の相違点については
+	<link linkend="changes.cui">
+	『<xref linkend="changes.cui">』
+	</link>
+	を参照して下さい。
+	</para>
     </listitem>
 
     <listitem>
 	<para>
-	CGI による操作:
+	GUI (CGI) による操作:
 		ＭＬの作成/削除、
 		メンバーの登録/削除/変更(chaddr)、
 		リモート管理者の登録/削除、
@@ -65,7 +89,10 @@
 
     <listitem>
 	<para>
-	コマンドメール(一般ユーザ):
+	<link linkend="usage.user">
+	コマンドメール(一般ユーザ)
+	</link>
+	:
 		メンバーの登録/削除/変更(chaddr)、
 		リモート管理者の登録/削除、
 		ログを見る、
@@ -84,7 +111,9 @@
 
     <listitem>
 	<para>
+	<link linkend="error.internal">
 	エラーメールの自動解析
+	</link>
 	</para>
     </listitem>
 
@@ -99,7 +128,8 @@
     <listitem>
 	<para>
 	スレッド追跡システム(CUI と CGI を含む):
-	(fmlthread fmlthread.cgi)
+	一度、作ったのですが、最初のバージョンは削除され、
+	2004/03 に総書き直しされました。
 	</para>
     </listitem>
 
@@ -107,7 +137,8 @@
     <listitem>
 	<para>
 	記事の HTML 化(デフォルトで HTML 版も作る):
-	fmlhtmlify および makefml に HTML 化コマンドがあります。
+	デフォルトで作っています。別途、
+	fmlhtmlify および makefml に HTML 化コマンドもあります。
 	</para>
     </listitem>
 
@@ -115,7 +146,7 @@
     <listitem>
 	<para>
 	MTA が起動するメインのプログラム:
-	fml.pl distribute command error
+	distribute command error
 	</para>
     </listitem>
 
@@ -127,8 +158,6 @@
 	fmlailas
 	fmlconf
 	fmldoc
-	fmlhtmlify
-	fmlsch
 	makefml
 	fml
 	</para>
@@ -160,29 +189,33 @@
 <important>
 
 <para>
-インスール方法は GNU autoconf を使うデファクトスタンダードなものとなっ
-ています。&fml4; にあまり似ていません。ですが、OS 附属のパッケージシス
-テムなどにはやさしくなっているといえるでしょう。
+インスール方法は GNU autoconf を使うデファクトスタンダード(configure 
+そして make)なものとなっています。&fml4; にあまり似ていません。ですが、
+OS 附属のパッケージシステムなどにはやさしくなっているといえるでしょう。
 </para>
 
 <para>
-インストールにおける主な注意点/&fml4;との相違点は、
+&fml8; のインストールにおける主な注意点(&fml4;との相違点)は、
 「root での作業」、
 「configure の使用」、
-そして /usr/local/etc/fml/ 以下のファイル、
-特に 
-/usr/local/etc/fml/main.cf 
+/usr/local/etc/fml/
+のファイル編集です。
+&fml8; の
+/usr/local/etc/fml/
+以下のファイル群は
+&fml4; の
+/usr/local/fml/.fml 以下のファイル群
 および
 /usr/local/etc/fml/site_default_config.ph
-というグローバルな設定ファイルの編集などです。
+などに相当していますが、必ずしも一対一対応するわけではありません。
 </para>
 
 </important>
 
 
 <para>
-さて、いつものように elena ＭＬ(elena@fml.org)の作成過程を例にとりましょ
-う。インストールのおおまかな流れは次のようになります。
+さて、いつものように Unix 上で elena ＭＬ(elena@fml.org)を作成するケー
+スを例にとりましょう。インストールのおおまかな流れは次のようになります。
 </para>
 
 
@@ -199,6 +232,7 @@
 	<para>
 	<link linkend="install.fml.unix">
 	ユーザ root でインストールをします。
+	</link>
 	ユーザ root になったら、
 	まずはユーザ fml とグループ fml を作成します。
 	その後、
@@ -206,7 +240,6 @@
 	configure
 	</link>
 	および make install を実行して下さい。
-	</link>
 <screen>
 % su root
 # groupadd fml
@@ -221,7 +254,8 @@
 		<footnote>
 		<para>
 		デフォルトでは /usr/local ディレクトリ以下に
-		適宜サブディレクトリが作られます。
+		4.4 BSD 風のサブディレクトリが作られます。
+		ディレクトリパスは
 		<link linkend="install.fml.unix.configure">
 		configure のオプション
 		</link>
@@ -249,14 +283,14 @@
 % su fml
 % fml elena newml
 </screen>
-でも OK になりました。
+でも同じ意味です(注意: fml コマンドは &fml8; にしかありません)。
 	</para>
    </listitem>
 
 
    <listitem>
 	<para>
-	MTA から fml を起動するために
+	MTA から &fml8; の配送プログラムなどを起動するために、
 	MTA の設定をしてください。
 	</para>
    </listitem>
@@ -272,7 +306,7 @@
    <listitem>
 	<para>
 	<link linkend="guide.config.cf">
-	ＭＬ のカスタマイズをする。
+	ＭＬ のカスタマイズをしてください。
 	</link>
 	</para>
    </listitem>
@@ -295,7 +329,7 @@
 	</title>
 
 <para>
-makefml を使ってＭＬを作成します。
+makefml コマンドを使ってＭＬを作成します。
 デフォルトのドメイン(例: fml.org)の場合、
 makefml の使い方は &fml4; の時と同様です。
 elena@fml.org ＭＬを作るには
@@ -312,8 +346,11 @@ elena@fml.org ＭＬを作るには
 </para>
 
 <para>
-一方、バーチャルドメイン(nuinui.net)の場合は、
-ＭＬのアドレスを全部指定して下さい。
+一方、
+<link linkend="virtualdomain">
+バーチャルドメイン(nuinui.net)
+</link>
+の場合は、ＭＬのアドレスを全部指定して下さい。
 たとえば elena@nuinui.net を作る場合は、次のように実行します。
 <screen>
 % su fml
@@ -321,13 +358,25 @@ elena@fml.org ＭＬを作るには
 </screen>
 </para>
 
+<warning>
+<para>
+バーチャルドメイン(nuinui.net)のＭＬを作る場合、最初の一回目には、「そ
+のドメインを使う」ための宣言(おまじない?)が必要です。くわしくは
+<link linkend="virtualdomain">
+<xref linkend="virtualdomain">
+</link>
+を参照して下さい。
+</para>
+</warning>
+
 </sect1>
 
 
 <!-- ============================================================= -->
 <sect1 id="guide.subscribe">
-
-   <title> ＭＬのメンバーを登録する </title>
+	<title>
+	ＭＬのメンバーを登録する
+	</title>
 
 <para>
 デフォルトのドメイン(例: fml.org)の場合は、
@@ -349,8 +398,9 @@ elena@fml.org ＭＬを作るには
 
 <!-- ============================================================= -->
 <sect1 id="guide.unsubscribe">
-
-   <title> ＭＬのメンバーから削除する </title>
+	<title>
+	ＭＬのメンバーから削除する
+	</title>
 
 <para>
 デフォルトのドメイン(例: fml.org)の場合は、
@@ -391,10 +441,10 @@ elena@fml.org ＭＬを作るには
 
 <para>
 /usr/local/etc/fml/site_default_config.cf
-はこのホストで動く fml すべてに影響を与えます。
+は、このホストで動く fml すべてに影響を与えます。
 <footnote>
 <para>
-これは &fml4; の site_init.ph に相当するものです。
+これは &fml4; の site_force.ph に相当するものです。
 </para>
 </footnote>
 </para>
@@ -402,7 +452,10 @@ elena@fml.org ＭＬを作るには
 <para>
 site_default_config.cf のフォーマットは、config.cf (後述)と同様で、
 指定できる変数も config.cf と同じです。
-全変数のリストは default_config.ph (後述)を見て下さい。
+<link linkend="list.variables.by.alphabeticalorder">
+全変数のリスト
+</link>
+は default_config.ph (後述)を見て下さい。
 </para>
 
 </sect2>
@@ -417,8 +470,11 @@ site_default_config.cf のフォーマットは、config.cf (後述)と同様で、
 elena ＭＬの設定のカスタマイズは 
 /var/spool/ml/elena/config.cf
 を編集して下さい。
-フォーマットは postfix の設定ファイルと同様です(&fml4; の config.ph よ
-りは cf にやや近いですが、フォーマットが違うことに変わりはない)。
+<link linkend="internal.config.cf">
+フォーマットは postfix の設定ファイル
+</link>
+と同様です(&fml4; の config.ph よりは cf にやや近いですが、フォーマッ
+トが違うことに変わりはない)。
 </para>
 
 <para>