summaryrefslogtreecommitdiff
path: root/fml/doc/ja/tutorial
diff options
context:
space:
mode:
authorfukachan <fukachan>2001-11-19 14:55:15 +0000
committerfukachan <fukachan>2001-11-19 14:55:15 +0000
commit4c7018e5a6470e53388a2daa1e6094340e8299c4 (patch)
treed1b7155a3c3ee3dff6101d5224266819eeeeea17 /fml/doc/ja/tutorial
parent11e2ac795ed22558d769c0bbad3038a5d626015f (diff)
downloadfml8-4c7018e5a6470e53388a2daa1e6094340e8299c4.tar.gz
fml8-4c7018e5a6470e53388a2daa1e6094340e8299c4.tar.bz2
fml8-4c7018e5a6470e53388a2daa1e6094340e8299c4.zip
update to catch up current
Diffstat (limited to 'fml/doc/ja/tutorial')
-rw-r--r--fml/doc/ja/tutorial/book.sgml8
-rw-r--r--fml/doc/ja/tutorial/devel/cvstree.sgml39
-rw-r--r--fml/doc/ja/tutorial/devel/docbook.sgml59
-rw-r--r--fml/doc/ja/tutorial/devel/inet6.sgml32
-rw-r--r--fml/doc/ja/tutorial/glossary.sgml40
-rw-r--r--fml/doc/ja/tutorial/include/chapters.ent11
-rw-r--r--fml/doc/ja/tutorial/install/chapter.sgml45
-rw-r--r--fml/doc/ja/tutorial/overview/chapter.sgml28
-rw-r--r--fml/doc/ja/tutorial/overview/download.sgml7
-rw-r--r--fml/doc/ja/tutorial/preface.sgml242
10 files changed, 313 insertions, 198 deletions
diff --git a/fml/doc/ja/tutorial/book.sgml b/fml/doc/ja/tutorial/book.sgml
index 139c9cd9..415fbf83 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.17 2001/10/13 08:47:54 fukachan Exp $
+$FML: book.sgml,v 1.18 2001/10/22 11:08:05 fukachan Exp $
-->
<!doctype book public "-//FML//DTD DocBook V3.1-Based Extension//EN" [
@@ -60,9 +60,9 @@ $FML: book.sgml,v 1.17 2001/10/13 08:47:54 fukachan Exp $
&chapter.replybyfml;
&chapter.fmlcommand;
- <!-- チケットシステム -->
- &chapter.ticket.usage;
- &chapter.ticket.tools;
+ <!-- スレッド追跡システム -->
+ &chapter.threadtrack.usage;
+ &chapter.threadtrack.tools;
</part>
diff --git a/fml/doc/ja/tutorial/devel/cvstree.sgml b/fml/doc/ja/tutorial/devel/cvstree.sgml
index 54745add..c87dce07 100644
--- a/fml/doc/ja/tutorial/devel/cvstree.sgml
+++ b/fml/doc/ja/tutorial/devel/cvstree.sgml
@@ -2,15 +2,17 @@
$FML
-->
-<chapter id="dirhier">
-
-<title> cvs tree の構造 </title>
+<chapter id="cvs.dirhier">
+ <title>
+ cvs repository の構造
+ </title>
<!-- ===================================================== -->
-<sect1>
-
-<title> ソースツリーの構造の概要 </title>
+<sect1 id="cvs.dirhier.summary">
+ <title>
+ ソースツリーの構造の概要
+ </title>
<para>
fml-devel の基本方針として、
@@ -22,21 +24,22 @@ fml-devel の基本方針として、
また、保守する人をはっきり区別するためにベンダーごとにディレクトリを分
けています。例えば CPAN で保守されているものは CPAN/ ディレクトリ以下
に入れてください。
+ライセンスなどによっては、
+将来さらに区分を分ける必要が出てくるかも知れません。
</para>
<para>
-ライセンスなどによっては、さらに区分を分ける必要が出てくるかも知れませ
-ん。が、とりあえずこの3つにわかれます。
-</para>
-
-<para>
-CPAN/ や 3RDPARTY/ 以下のモジュールを変更したい場合は fml5/ 以下でなん
-らかのラップをするか、パッチをオリジナルに反映してもらって CPAN/ 以下
-をアップデートをします。
+CPAN/ や 3RDPARTY/ 以下のモジュールを変更したい場合は fml5/ 以下で、
+なんらかのラップをするか、パッチをオリジナルに反映してもらって CPAN/
+以下をアップデートをすることが望ましいやり方です。
+CPAN/lib/ に直接変更を加えることもあります。
+CPAN/dist/ はオリジナルを保存する場所なので、変更してはいけません。
</para>
<para>
-なお site_local/ はそのサイト独自のものなので fml プロジェクトとは無関係です。
+なお site_local/ はそのサイト独自の module を置くディレクトリと定義さ
+れています。
+つまり fml プロジェクトとは無関係です。
</para>
</sect1>
@@ -44,7 +47,9 @@ CPAN/ や 3RDPARTY/ 以下のモジュールを変更したい場合は fml5/ 以下でなん
<!-- ===================================================== -->
<sect1>
- <title> CVS のディレクトリ構造 </title>
+ <title>
+ CVS のディレクトリ構造
+ </title>
<sect2>
<title> / 以下のディレクトリ構造 </title>
@@ -168,7 +173,7 @@ CPAN/ や 3RDPARTY/ 以下のモジュールを変更したい場合は fml5/ 以下でなん
<entry> fml/libexec/ </entry>
<entry>
実行されるプログラムの実体。
- もっともすぐにモジュールを
+ すぐにモジュールを
呼び出すので、正確には wrapper です。
</entry>
</row>
diff --git a/fml/doc/ja/tutorial/devel/docbook.sgml b/fml/doc/ja/tutorial/devel/docbook.sgml
index 3528df49..ca840597 100644
--- a/fml/doc/ja/tutorial/devel/docbook.sgml
+++ b/fml/doc/ja/tutorial/devel/docbook.sgml
@@ -1,11 +1,12 @@
<!--
- $FML: docbook.sgml,v 1.5 2001/05/02 11:38:24 fukachan Exp $
+ $FML: docbook.sgml,v 1.1 2001/05/09 09:37:35 fukachan Exp $
-->
-<appendix id="docbook">
-
-<title> SGML の書き方 </title>
+<appendix id="docbook">
+ <title>
+ SGML の書き方
+ </title>
<para>
fml-devel (fml 5.0) のドキュメントでは、SGML の DTD は
@@ -103,9 +104,8 @@ SGML を使うことで得られる最大の意義は「ある基準となるもの」に
<para>
ここで”概念”といっているのであって、”見栄え”については
-降れていないことに注意して下さい。
-HTML では概念と見栄えは(むしろ意識的に)はっきり分離していないといえま
-す。
+ふれていないことに注意して下さい。
+例えば HTML では概念と見栄えは(むしろ意識的に)はっきり分離していません。
</para>
<para>
@@ -121,7 +121,6 @@ DSSSL (Document Style Semantics and Specification Language)
を使います。
</para>
-
<para>
また SGML では論理構造しか記述しないので見栄えはコンバータ次第で
どうとでもなります。
@@ -135,8 +134,9 @@ HTML、テキスト、ROFF、PS、PDF、RTF を始め、
<!-- ========================================================= -->
<sect1 id="book.sgml">
-
-<title> 本( book )形式のテンプレート </title>
+ <title>
+ 本( book )形式のテンプレート
+ </title>
<para>
docbook DTD には book や article といった代表的な形式についての
@@ -209,7 +209,9 @@ include するべき定義ファイルを
<!-- ========================================================= -->
<sect1>
- <title> HTML の &lt;UL&gt; 相当 </title>
+ <title>
+ HTML の &lt;UL&gt; 相当
+ </title>
<screen>
&lt;itemizedlist&gt;
@@ -384,7 +386,13 @@ include するべき定義ファイルを
<para>
SGML を HTML などに翻訳するために、いくつかのツールが必要です。
DTD と DSL の規格文書群は必須です。
-おそらく openjade と opensp も必須のプログラムです。
+処理系として openjade と opensp
+ <footnote>
+ <para>
+ opensp は openjade パッケージに含まれています。
+ </para>
+ </footnote>
+も必須のプログラムです。
その他はオプショナルで、各自が好きにすればよいようです。
</para>
@@ -407,7 +415,7 @@ fml 5.0 では、以下のプログラムを使って HTML やテキストファイルを作成し
<listitem>
<para>
- SGMLtools-Lite 3.0.2
+ SGMLtools-Lite 3.0.3
</para>
</listitem>
@@ -417,14 +425,14 @@ fml 5.0 では、以下のプログラムを使って HTML やテキストファイルを作成し
</para>
<para>
-なお
-sgmltools がなくても SGML から HTML を作ることができます。
+もちろん sgmltools がなくても SGML から HTML を作ることができます。
どのツールを使うかは、あなたがどれを便利に思うか?次第です。
+単に &fml5; では、sgmltools を歴史的に使っているだけです。
</para>
<para>
-SGML からの変換には
-fml/doc/share/sgml/ にある fml.dtd fml.dsl も使っています。
+また、SGML からの変換には
+fml/doc/share/sgml/ にある fml.dtd fml.dsl を定義として使っています。
これらは各 Makefile 内に
定義(jade に与えるオプション -c や -d オプション)が記述されています。
</para>
@@ -479,17 +487,18 @@ sgmltools は /etc/sgml/catalog ファイルを使います。
<!-- ========================================================= -->
<sect1>
-
-<title> 見栄えを変更する </title>
+ <title>
+ 見栄えを変更する
+ </title>
<para>
SGML は論理的な構造を記述している言語です。
HTML の各ページに URL をつけたいとか、画像をつけたいといった
-”見栄えの記述”は直接はできません。
+"見栄えの記述"を SGML で直接変更することはできません。
</para>
<para>
-そこで、見栄えは DSL により記述をすることになります。
+見栄えは DSL により記述をすることになります。
しかしながら、DSL は本質的に LISP (List Processre) 言語なので、
LISP を知らないとちょっと手が出ないでしょう。
</para>
@@ -513,9 +522,9 @@ LISP を知らないとちょっと手が出ないでしょう。
<sect1>
- <title>
- その他の情報源
- </title>
+ <title>
+ その他の情報源
+ </title>
<para>
SGML の書き方については
@@ -542,7 +551,7 @@ SGML のタグの一覧は
DOCBOOK definitive guide (O'reilly)
</ulink>
-のオンライン版を参照すると良いでしょう。
+のオンライン版を参照するのが便利です。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/devel/inet6.sgml b/fml/doc/ja/tutorial/devel/inet6.sgml
index e1aaab0b..c68ec914 100644
--- a/fml/doc/ja/tutorial/devel/inet6.sgml
+++ b/fml/doc/ja/tutorial/devel/inet6.sgml
@@ -1,10 +1,12 @@
<!--
- $FML: inet6.sgml,v 1.1 2001/05/17 04:00:43 fukachan Exp $
+ $FML: inet6.sgml,v 1.2 2001/08/22 22:34:44 fukachan Exp $
-->
<appendix id="inet6">
-<title> NetBSD 1.5 での IPv6 の設定 </title>
+ <title>
+ NetBSD 1.5 での IPv6 の設定
+ </title>
<para>
<ulink url="http://www.netbsd.org/Documentation/network/ipv6/">
@@ -14,7 +16,9 @@ NetBSD の IPv6 の解説
</para>
<sect1>
- <title> IIJ IPv6 トンネル型サービスの場合 </title>
+ <title>
+ IIJ IPv6 トンネル型サービスの場合
+ </title>
<para>
まず、上流 ISP から IPv6 アドレス空間を割り当ててもらいます。
@@ -52,7 +56,9 @@ route6d を何も考えずに起動すると /64 を advertise してしまうので
</sect1>
<sect1>
- <title> トンネルの設定 </title>
+ <title>
+ トンネルの設定
+ </title>
<para>
gif インターフェイスを使ってトンネルを張ります。
@@ -90,7 +96,9 @@ tunnel 10.1.1.1 10.2.2.2
<sect1>
- <title> ルーティング </title>
+ <title>
+ ルーティング
+ </title>
<para>
IIJ のルータからは ::/0 (IPv4 なら 0/0) つまりデフォルトルートが
@@ -114,7 +122,9 @@ route6d=YES route6d_flags="-A 2001:240:22::/48,gif0"
<sect1>
- <title> ホストなどへのアドレスの割り当て </title>
+ <title>
+ ホストなどへのアドレスの割り当て
+ </title>
<para>
適宜ふるなり、rtadvd か rtsold で自動で割り当てるなりします。
@@ -125,7 +135,7 @@ route6d=YES route6d_flags="-A 2001:240:22::/48,gif0"
<sect1>
<title>
- references
+ リファレンス
</title>
<para>
@@ -161,6 +171,14 @@ www.kame.net
</ulink>
</para>
+
+<para>
+<ulink url="http://www.kame.net/newsletter/19980604/">
+"Implementing AF-independent application"
+</ulink>
+</para>
+
+
<para>
Interview with Jun-ichiro "Itojun" Hagino about the KAME Project
<ulink url="http://www.feyrer.de/NetBSD/interview-itojun.html">
diff --git a/fml/doc/ja/tutorial/glossary.sgml b/fml/doc/ja/tutorial/glossary.sgml
index 3c70a511..327d367a 100644
--- a/fml/doc/ja/tutorial/glossary.sgml
+++ b/fml/doc/ja/tutorial/glossary.sgml
@@ -1,9 +1,11 @@
<!--
- $FML$
+ $FML: glossary.sgml,v 1.1 2001/04/25 02:55:56 fukachan Exp $
-->
<glossary id="glossary">
- <title> 用語集(関数名および変数名関連) </title>
+ <title>
+ 用語集(関数名および変数名関連)
+ </title>
<glossentry>
@@ -24,6 +26,11 @@
遠い将来に
fml 5.0 になるであろうとおもわれる fml-current
</para>
+
+ <para>
+ もしかしたら fml 8.x の方が適切かも知れない。
+ だが、まだ決まっていない。
+ </para>
</glossdef>
@@ -34,7 +41,11 @@
<glossterm> curproc </glossterm>
<glossdef>
<para>
- "current process"の略
+ "current process"の略。
+ </para>
+
+ <para>
+ UNIX カーネルで伝統的に使われている省略名の典型例
</para>
</glossdef>
@@ -50,6 +61,10 @@
現状 fml 内部でのコンテキスト切替などはないので、
UNIX カーネルの PCB とは少し趣が異なります。
</para>
+
+ <para>
+ UNIX カーネルで伝統的に使われている省略名の典型例
+ </para>
</glossdef>
</glossentry>
@@ -62,8 +77,16 @@
configuration の略
</para>
</glossdef>
+ </glossentry>
+ <glossentry>
+ <glossterm> conf </glossterm>
+ <glossdef>
+ <para>
+ configuration の略
+ </para>
+ </glossdef>
</glossentry>
@@ -121,6 +144,12 @@
慣習的にパッケージ、クラス、オブジェクト内部で使う
変数や関数名に _ ではじまるキーワードを使う。
</para>
+
+ <para>
+ つまり private ということ(
+ OO の厳密な意味で private method という意味か?などとは
+ つっこまないようにしたい:-)
+ </para>
</glossdef>
</glossentry>
@@ -129,9 +158,10 @@
<glossterm> rなになに </glossterm>
<glossdef>
<para>
- r はリファレンスの略。ハンガリアン記法。
+ r はリファレンスの略。
+ これをハンガリアン記法と呼ぶ。
特別に強調したい場合に使うことがあるが、
- あまり使っていない。
+ fml 内部では、あまり使っていない。
</para>
</glossdef>
</glossentry>
diff --git a/fml/doc/ja/tutorial/include/chapters.ent b/fml/doc/ja/tutorial/include/chapters.ent
index 6a1be3bf..41a1a8cc 100644
--- a/fml/doc/ja/tutorial/include/chapters.ent
+++ b/fml/doc/ja/tutorial/include/chapters.ent
@@ -1,12 +1,12 @@
<!--
- $FML: chapters.ent,v 1.18 2001/10/13 08:47:55 fukachan Exp $
+ $FML: chapters.ent,v 1.19 2001/10/22 11:08:05 fukachan Exp $
-->
<!entity versin "1.1">
<!-- ポインタ -->
<!entity fmlbible "『fml バイブル』(オライリージャパン刊)">
-<!entity www.fml.org "http://www.fml.org/fml/">
+<!entity www.fml.org "http://www.fml.org/software/fml/">
<!entity fml4 "fml 4.0">
<!entity fml5 "fml 5.0">
@@ -63,8 +63,10 @@
<!-- misc -->
-<!entity chapter.ticket.usage SYSTEM "ticketsystem/chapter.sgml">
-<!entity chapter.ticket.tools SYSTEM "ticketsystem/tools.sgml">
+<!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">
<!-- プログラムの説明 -->
@@ -72,6 +74,7 @@
<!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">
diff --git a/fml/doc/ja/tutorial/install/chapter.sgml b/fml/doc/ja/tutorial/install/chapter.sgml
index b1b7642a..4e2b73e0 100644
--- a/fml/doc/ja/tutorial/install/chapter.sgml
+++ b/fml/doc/ja/tutorial/install/chapter.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: chapter.sgml,v 1.4 2001/05/01 15:16:27 fukachan Exp $
+ $FML: chapter.sgml,v 1.5 2001/10/13 08:47:56 fukachan Exp $
-->
<chapter id="installation">
@@ -11,22 +11,51 @@
<sect1 id="install">
<title> 概要 </title>
-<para>
-対話型インストーラは"まだ"作られていません。
-</para>
<para>
-make を実行して下さい。
+configure (GNU autoconf) および make を実行して下さい。
<screen>
% su root
+# ./configure
# make install
</screen>
-これはシェルスクリプト INSTALL.sh を実行するだけです。
+make install はシェルスクリプト INSTALL.sh を実行するだけです :-)
</para>
<para>
-変更が必要ならトップ・ディレクトリにある INSTALL.sh の先頭にあるディレ
-クトリ名などを適当に修正し、ユーザ root で実行して下さい。
+変更が必要なら configure の引数で変更して下さい。
+変更できる変数は以下のものです。
+fml では各ディレクトリにさらに /fml といった suffix をつけます。
+変更できるのはその直前の prefix 部分までです。
+<screen>
+変数 configure のデフォルト値 fml の利用するディレクトリ
+--------------------------------------------------------
+prefix /usr/local /usr/local
+exec_prefix /usr/local
+bindir ${exec_prefix}/bin /usr/local/bin
+sbindir ${exec_prefix}/sbin /usr/local/sbin
+libexecdir ${exec_prefix}/libexec /usr/local/libexec/fml
+datadir ${prefix}/share /usr/local/share/fml
+sysconfdir ${prefix}/etc /usr/local/etc/fml
+sharedstatedir ${prefix}/com
+localstatedir ${prefix}/var
+libdir ${exec_prefix}/lib /usr/local/lib/fml
+includedir ${prefix}/include
+oldincludedir /usr/include
+infodir ${prefix}/info
+mandir ${prefix}/man
+</screen>
+また
+<screen>
+mlspooldir /var/spool/ml /var/spool/ml
+fml_owner fml fml
+</screen>
+これらの変数は、それぞれ
+<screen>
+--with-mlspooldir=DIR
+--with-fml-owner=USER
+</screen>
+で上書きすることができます。
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/overview/chapter.sgml b/fml/doc/ja/tutorial/overview/chapter.sgml
index 8759d382..c41d7d64 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.2 2001/05/07 03:16:25 fukachan Exp $
+ $FML: chapter.sgml,v 1.3 2001/10/13 08:47:57 fukachan Exp $
-->
<chapter id="overview">
@@ -10,19 +10,6 @@
<sect1>
<title> 概要 </title>
-<warning>
-<para>
-fml-devel
-は動くとはいえ、まだまだ開発者向けのプログラムであることに注意して
-下さい。実運用には
- <ulink url="http://www.fml.org/fml/">
- &fml4;
- </ulink>
-系を御利用下さい。
-</para>
-</warning>
-
-
<para>
以下で、特に触れていない概念(例: MLとは?)については &fml4; と同様
です。4.0 の資料(
@@ -54,14 +41,18 @@ fml-devel
<link linkend="install">
ユーザ root でインストールをする。
</link>
+<screen>
+# ./configure
+# make install
+</screen>
</para>
<para>
- インストーラは /usr/local/bin に
+ (デフォルトでは)インストーラは /usr/local/bin に
<link linkend="available">
- fmldoc fmlconf fmlticket makefml
+ fmldoc fmlconf fmlthread makefml fmlhtmlify
</link>
- をインストールします。
+ などをインストールします。
</para>
<para>
@@ -78,6 +69,9 @@ fml-devel
<link linkend="guide.newml">
ユーザ fml で elena MLを作る。
</link>
+<screen>
+% makefml newml elena
+</screen>
</para>
</listitem>
diff --git a/fml/doc/ja/tutorial/overview/download.sgml b/fml/doc/ja/tutorial/overview/download.sgml
index d221296b..497e75dc 100644
--- a/fml/doc/ja/tutorial/overview/download.sgml
+++ b/fml/doc/ja/tutorial/overview/download.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: download.sgml,v 1.1 2001/05/01 15:38:06 fukachan Exp $
+ $FML: download.sgml,v 1.2 2001/10/13 08:47:58 fukachan Exp $
-->
<chapter id="download">
@@ -27,6 +27,11 @@ fml-devel のソースは
<para>
なお daily snapshot もあります。
+
+<ulink url="ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/">
+ftp://ftp.fml.org/pub/fml/daily-snapshots/fml-devel/source/
+</ulink>
+
</para>
</sect1>
diff --git a/fml/doc/ja/tutorial/preface.sgml b/fml/doc/ja/tutorial/preface.sgml
index 1f78968f..b7c5bb81 100644
--- a/fml/doc/ja/tutorial/preface.sgml
+++ b/fml/doc/ja/tutorial/preface.sgml
@@ -1,5 +1,5 @@
<!--
- $FML: preface.sgml,v 1.8 2001/08/26 05:55:51 fukachan Exp $
+ $FML: preface.sgml,v 1.9 2001/09/17 13:04:24 fukachan Exp $
-->
<preface>
@@ -8,13 +8,37 @@
</title>
+<warning>
+<para>
+ドキュメントも不十分だし、
+機能も不十分なので、
+実運用には fml-devel を使わずに 4.0 stable を使う方がよいでしょう。
+</para>
+
+<para>
+2001 年も終りに近付く今日この頃、
+fml-devel は開発用で fml-current ですらないことに変わりはありませんが、
+十分実用的に動いています。
+makefml や CGI でユーザの登録などもできるし、
+HTML 化機能+スレッド追跡システムは便利で、
+作者は、(特に 4.0 にない諸機能を使うために)運用ベースで使っています。
+ただ、多くのこまごまとした機能は未実装ですし、
+再デザインの研究最終段階といったあたりにあります。
+</para>
+</warning>
+
+
+
<!-- ======================================================== -->
<sect1>
-<title> はるかなる fml 5.0 への道 </title>
+ <title>
+ 次世代 fml への道
+ </title>
<para>
-fml 5.0 とは fml 4.0 を一から書き直す次世代 fml プロジェクトの総称
+fml-devel もしくは fml 5.0 (仮称) プロジェクト
+とは fml 4.0 を一から書き直す次世代 fml プロジェクトの総称
<footnote>
<para>
ざっくりとしたイメージしては
@@ -23,120 +47,86 @@ fml 5.0 とは fml 4.0 を一から書き直す次世代 fml プロジェクトの総称
</para>
</footnote>
です。
-fml 4.0 までに至る約 10 年の経験を再実装する試みといえます。
-これには何年もの歳月がかかるでしょう。
+これは fml 4.0 までに至る約 10 年の経験を再実装する試みといえます。
+つまり、この試みには何年もの歳月がかかっても不思議はないでしょう。
</para>
-<warning>
<para>
-実運用には fml-devel を使わずに 4.0 stable を使って下さい。
-fml-devel は開発用で、 fml-current ですらありません。
+次世代 fml の考え方は fml 4.0 の”機能”を再構想/再実装することです。
+これはデザインを一から考え直すことに加え、
+機能や変数の整理整頓も含みます。
</para>
-</warning>
<para>
-fml 5.0 への道(はるかなる道)について、
-現在は次のような構想を持っています。
-基本的な考え方は fml 4.0 の”機能”を再構想/再実装することです。
-</para>
+まず最初するべきことは 4.0 の機能とそのデザインについての再検討です。
+例えば、次のような項目が挙げられます。
-<para>
-まず最初にしたいことは 4.0 の機能についての再検討です。
-例えば、次のような項目です。
+ <itemizedlist>
-<itemizedlist>
- <listitem>
+ <listitem>
<para>
5.0 へ引き継ぐものは何か?
</para>
- </listitem>
+ </listitem>
+
- <listitem>
+ <listitem>
<para>
5.0 でもっとうまく、よりカスタマイズしやすいものに実装できないか?
</para>
- </listitem>
+ </listitem>
- <listitem>
+
+ <listitem>
<para>
もう要らないものは何か?
</para>
- </listitem>
+ </listitem>
-</itemizedlist>
+ </itemizedlist>
これらについての意見を募集したいと思っています。ですが、漠然と議論して
-もしょうがないので、議論の叩き台としてある程度動くものを作りました。
-
- <ulink url="ftp://ftp.fml.org/pub/fml-devel/">
- ftp://ftp.fml.org/pub/fml-devel/
- </ulink>
-
-にあります。まだまだ 5.0 の α 版ではなく、プロトタイプですらないので、
-リリースなどではありません。これは、あくまでもアイデアを表現するための
-ものですが、配送プログラムとしては十分動きます。fml-devel MLをはじめ
-として、いくつか運用テストに入っているものがあります。
-また、チケットシステムも同様に実運用ベースでテストされています。
+もしょうがないので、議論の叩き台として動くものを作りつつあります。
</para>
<para>
-最初に実装するのは
-<emphasis>
-fml 1.2 相当の最低限の機能に makefml が加わったもの
-</emphasis>
-だろうと考えています。
-</para>
-
-</sect1>
-
-
-<!-- ======================================================== -->
-<sect1>
-
-<title> fml-devel プロジェクトの構想 </title>
-
-<para>
-fml 5.0 ないしは
-<ulink url="http://www.fml.org/devel/">
-fml-devel
+<ulink url="http://www.fml.org/software/fml-devel/">
+http://www.fml.org/software/fml-devel/
</ulink>
-とも呼んでいる fml 5.0 プロジェクトは、
-fml 4.0 の再構想(refactoring)とその実装(例)の構築
-を行なっています。
</para>
<para>
-<ulink url="http://www.fml.org/devel/">
-http://www.fml.org/devel/
+<ulink url="ftp://ftp.fml.org/pub/fml-devel/">
+ftp://ftp.fml.org/pub/fml-devel/
</ulink>
-では将来の fml-current についてのデザインや実装例を紹介しています。
</para>
-
<para>
-これは fml 5.0 のアイデアを募るための、
-fml 5.0 のアルファ版のアルファ版のアルファ版
-もしくは
-プロトタイプ
-とでもいうべきものです。ですが、すでに動く実装例をダウンロードできます
-し、fml 1.2 相当の機能を使うこともできます。しかしながら、変数名もアー
-キテクチャア
-も本決まりではないので、将来変わる可能性があります。
+これは、あくまでもアイデアを表現するためのものなので、機能は最低限のも
+のしかありませんが、十分動きます。
+作者は fml-devel MLをはじめ、
+いくつかの場所で運用ベースで使っています。
</para>
<para>
また、多くの機能が実装されていません。これは、デザインを最初から考え直
すにあたり、アイデアや意見を募集するためにまだまだ原型にとどまっている
ためでもあります。
+そして、変数名もアーキテクチャアも本決まりではないので、将来変わ
+る可能性があります。
</para>
+
<para>
-ものによっては fml 5.0 用に作られたモジュールを fml 4.0 へ
-輸入/輸出することも検討しています。
-たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)などは
-その良い例だろうし、新機能を提供するモジュールなども再輸入(輸出)可能な
-ものは順次マージしていきます。
+最初の mile stone としてお試しリリースされる際には、
+<screen>
+fml 1.2 相当の最低限の機能
++ makefml (CUI + CGI) が加わったもの
++ 自動スレッド追跡システム
++ 自動 HTML 化機構
+</screen>
+が動く状態のものだろうという見通しです。
</para>
</sect1>
@@ -145,7 +135,9 @@ fml 5.0 のアルファ版のアルファ版のアルファ版
<!-- ======================================================== -->
<sect1>
-<title> fml 4.0 と 5.0 の関係 </title>
+ <title>
+ fml 4.0 と 5.0 の関係
+ </title>
<para>
fml-devel で作られたモジュールのマージおよび
@@ -168,77 +160,105 @@ fml-devel で作られたモジュールのマージおよび
4.0.1 4.0.2 .... (リリース / 4.0-stable バージョン)
</screen>
-<warning>
+
<para>
- 実運用には fml-devel を使わずに 4.0 stable を使って下さい。
- fml-devel は開発用で、 fml-current ですらありません。
+ものによっては fml 5.0 用に作られたモジュールを fml 4.0 へ
+輸入/輸出することも検討しています。
+たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)などは
+その良い例だろうし、新機能を提供するモジュールなども再輸入(輸出)可能な
+ものは順次マージしていきます。
+5.0 の機能を 4.0 でテストをするいう意味もあります。
+このマージは 4.0.4 か 4.0.5 以降本格化する予定です。
</para>
-</warning>
+
</sect1>
<!-- ======================================================== -->
<sect1>
- <title> fml5で既に動く機能 </title>
+ <title>
+ fml-devel で既に動く機能
+ </title>
<para>
-<itemizedlist>
+ <itemizedlist>
+
- <listitem>
+ <listitem>
<para>
- postfix スタイルの設定ファイル
+ postfix スタイルの設定ファイル
</para>
- </listitem>
+ </listitem>
- <listitem>
+
+ <listitem>
<para>
- 配送、ヘッダの書き換え、(単純な)フィルタ
+ 配送、
+ ヘッダの書き換え、
+ フィルタ( 4.0 の Envelope Filter に相当するもの )
</para>
- </listitem>
+ </listitem>
+
- <listitem>
+ <listitem>
<para>
- いくつかのユーティリティプログラム:
- fmldoc fmlconf makefml fmlticket
+ いくつかのユーティリティプログラム:
+ fmldoc fmlconf makefml fmlthread
</para>
- </listitem>
+ </listitem>
- <listitem>
+
+ <listitem>
<para>
- IPv6
+ IPv6
</para>
- </listitem>
+ </listitem>
+
- <listitem>
+ <listitem>
<para>
- チケットシステム(最小限の機能、CGI 含む):
- fmlticket fmlticket.cgi
+ スレッド追跡システム(CUI と CGI を含む):
+ fmlthread fmlthread.cgi
</para>
- </listitem>
+ </listitem>
- <listitem>
- <para>
- <link linkend="io.adapter">
- 抽象化 IO 層
- </link>
- メンバーファイルをファイル、/etc/group, NIS, MySQL
- から取り出すことができます。
+ <listitem>
+ <para>
+ 記事の HTML 化システム
</para>
- </listitem>
-</itemizedlist>
+ </listitem>
-<link linkend="available"> 詳細はこちら </link>
+
+ <listitem>
+ <para>
+ <link linkend="io.adapter">
+ 抽象化 IO 層
+ </link>
+ メンバーファイルをファイル、/etc/group, NIS, MySQL
+ から取り出すことができます。
+ </para>
+ </listitem>
+ </itemizedlist>
+
+詳細は
+<link linkend="available">
+『fml-devel の実行形式プログラム』の章
+</link>
+を参照して下さい。
</para>
</sect1>
+
<!-- ======================================================== -->
<sect1 id="mailinglist">
- <title> メーリングリスト </title>
+ <title>
+ メーリングリスト
+ </title>
<para>
fml 5 の議論のためのメーリングリストを用意してあります。
@@ -288,7 +308,9 @@ fml-devel MLのログは
<!-- ======================================================== -->
<sect1>
-<title> ご意見募集中 </title>
+ <title>
+ ご意見募集中
+ </title>
<para>
5.0 のアイデアのついて、