diff options
| author | fukachan <fukachan> | 2001-11-19 14:55:15 +0000 |
|---|---|---|
| committer | fukachan <fukachan> | 2001-11-19 14:55:15 +0000 |
| commit | 4c7018e5a6470e53388a2daa1e6094340e8299c4 (patch) | |
| tree | d1b7155a3c3ee3dff6101d5224266819eeeeea17 /fml/doc/ja/tutorial | |
| parent | 11e2ac795ed22558d769c0bbad3038a5d626015f (diff) | |
| download | fml8-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.sgml | 8 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/devel/cvstree.sgml | 39 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/devel/docbook.sgml | 59 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/devel/inet6.sgml | 32 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/glossary.sgml | 40 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/include/chapters.ent | 11 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/install/chapter.sgml | 45 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/overview/chapter.sgml | 28 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/overview/download.sgml | 7 | ||||
| -rw-r--r-- | fml/doc/ja/tutorial/preface.sgml | 242 |
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 の <UL> 相当 </title> + <title> + HTML の <UL> 相当 + </title> <screen> <itemizedlist> @@ -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 のアイデアのついて、 |
