summaryrefslogtreecommitdiff
path: root/fml
diff options
context:
space:
mode:
authorfukachan <fukachan>2001-04-22 16:26:10 +0000
committerfukachan <fukachan>2001-04-22 16:26:10 +0000
commit93d28149ebdf2f87739a59193a71945053bb0fbc (patch)
tree56e67667a820010d5ed1c148e76077e0ead64dda /fml
parent13a122332bbed99c4c0df92d0a4778d729e6bb8b (diff)
downloadfml8-93d28149ebdf2f87739a59193a71945053bb0fbc.tar.gz
fml8-93d28149ebdf2f87739a59193a71945053bb0fbc.tar.bz2
fml8-93d28149ebdf2f87739a59193a71945053bb0fbc.zip
change hier to fml/doc/$lang/$what style
Diffstat (limited to 'fml')
-rw-r--r--fml/doc/ja/htdocs/__template.ja.html20
-rw-r--r--fml/doc/ja/htdocs/announce.ja.html127
-rw-r--r--fml/doc/ja/htdocs/architecture.html20
-rw-r--r--fml/doc/ja/htdocs/built_already.ja.html115
-rw-r--r--fml/doc/ja/htdocs/components.ja.html53
-rw-r--r--fml/doc/ja/htdocs/cvstag.ja.html57
-rw-r--r--fml/doc/ja/htdocs/dirhier.ja.html54
-rw-r--r--fml/doc/ja/htdocs/download.ja.html50
-rw-r--r--fml/doc/ja/htdocs/extension.ja.html35
-rw-r--r--fml/doc/ja/htdocs/guide.ja.html177
-rw-r--r--fml/doc/ja/htdocs/index.ja.html21
-rw-r--r--fml/doc/ja/htdocs/install.ja.html71
-rw-r--r--fml/doc/ja/htdocs/mailinglist.ja.html57
-rw-r--r--fml/doc/ja/htdocs/menubar.ja.html151
-rw-r--r--fml/doc/ja/htdocs/purpose.ja.html136
-rw-r--r--fml/doc/ja/htdocs/refactoring.ja.html145
-rw-r--r--fml/doc/ja/htdocs/releng.ja.html55
-rw-r--r--fml/doc/ja/htdocs/style.ja.html67
-rw-r--r--fml/doc/ja/htdocs/terms.ja.html110
-rw-r--r--fml/doc/ja/htdocs/upgrade.ja.html60
20 files changed, 1581 insertions, 0 deletions
diff --git a/fml/doc/ja/htdocs/__template.ja.html b/fml/doc/ja/htdocs/__template.ja.html
new file mode 100644
index 00000000..99676428
--- /dev/null
+++ b/fml/doc/ja/htdocs/__template.ja.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+ ... title ...
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+
+ ... body ...
+
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/announce.ja.html b/fml/doc/ja/htdocs/announce.ja.html
new file mode 100644
index 00000000..a48a809a
--- /dev/null
+++ b/fml/doc/ja/htdocs/announce.ja.html
@@ -0,0 +1,127 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 (仮名) プロジェクト アナウンス
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<PRE>
+ 次世代 fml プロジェクト
+ http://www.fml.org/devel/fmlsrc/index.ja.html
+
+ Copyright (C) 2001 Ken'ichi Fukamachi
+ 改変しない限り再配布は自由です
+
+
+
+fml 5.0 への道(はるかなる道)について現在次のように構想しています。
+基本的な考え方は fml 4.0 の”機能”を再構想/再実装することです。
+
+まず最初にしたいことは 4.0 の機能についての再検討です。例えば
+
+ 5.0 へ引き継ぐものは何か？
+ 5.0 でもっとうまく、よりカスタマイズしやすいものに実装できないか？
+ もう要らないものは何か？
+
+についての意見を募集したいと思っています。ですが、漠然と議論してもしょ
+うがないので、議論の叩き台としてある程度動くものを作りました。
+
+ ftp://ftp.fml.org/pub/fml-devel/
+
+にあります。まだまだ 5.0 の α 版ではなく、プロトタイプですらないので、
+リリースなどではありません。これは、あくまでもアイデアを表現するための
+ものですが、配送プログラムとしては十分動きます。fml-devel ＭＬをはじめ
+として、いくつか運用テストに入っているものがあります。
+＃注: 実運用には fml-devel を使わずに 4.0 stable を使って下さい。
+＃ fml-devel は開発用 fml-current ですらありません。
+
+現状動いている機能は
+
+ fml 1.2 相当の最低限の機能
+ + postfix スタイルの設定ファイル
+ + IPv6
+ + チケットシステム(最小限の機能、CGI 含む)
+ + 抽象化 IO 層
+ メンバーファイルをファイル、/etc/group, NIS, MySQL
+ から取り出す。
+ ＃ 3 行くらい変更すれば PostgreSQL も動くはず
+
+程度です。ざっくりとしたイメージは sendmail と postfix のような違いか
+と個人的には思っています。
+
+
+○ fml 4.0 と 5.0 の関係
+
+http://www.fml.org/devel/fmlsrc/fml/doc/purpose.ja.html
+
+4.0 と 5.0 はアイデアは継承していても、起源は別です。
+図解すれば次のようなものといえます。
+
+ -----------------------------> 5.0 (本プロジェクトの目標)
+ ↑↓交流
+1.2 〜 4.0 ------------------------------> 4.0-current
+ | |
+ 4.0.1 4.0.2 .... (リリース / 4.0-stable バージョン)
+
+今後 4.0 シリーズに投入する新機能は、原則として 5.0 ライン上で作ったも
+のを逆輸入する形になるでしょう。
+
+
+○ fml5で既に動く機能
+
+http://www.fml.org/devel/fmlsrc/fml/doc/built_already.ja.html
+
+
+これらのものは /usr/local/libexec/fml以下にインストールされます。実際には
+/usr/local/libexec/fml/loaderへのリンクです。起動される時の名前で振舞いを変
+えています。
+
+注意: fml5ではすべてのプログラムは /usr/local/libexec/fml/loaderを経由して
+起動されます。バージョン依存性を処理するために、つねにこの loaderを通して
+起動していくことになっています。
++------------------+--------------------------------------------------------+
+|fml.pl |配送処理をする。subjectを書き換える。スプールに記事とし |
+|distribute |て溜める。IPv6をしゃべる。チケット番号をふる。et. al. |
++------------------+--------------------------------------------------------+
+|command |プログラム自体は動きますが、機能するコマンドはまだない |
+|fml.pl --ctladdr |です。 |
++------------------+--------------------------------------------------------+
+|makefml |登録と削除関係、および最低限のＭＬの作成だけは動きます( |
+| |add subscribe |
+| |bye unsubscribe resign remove |
+| |そして newml)。使い方は fml 4.0と一緒です。 |
+| |% makefml add elenaアドレス |
+| |% makefml bye elenaアドレス |
+| |% makefml newml elena |
++------------------+--------------------------------------------------------+
+|makefml.cgi |makefmlの CGIインターフェイス。うごくけど、まだプロトタ |
+| |イプ。動く機能は makefmlと同等のものです。それは最終的 |
+| |に makefmlと同じ関数を呼び出しているからです。 |
++------------------+--------------------------------------------------------+
+|fmlconf |変数一覧を表示します |
++------------------+--------------------------------------------------------+
+|fmldoc |モジュールのマニュアルを表示する |
+| |perldocへの wrapperです。 |
++------------------+--------------------------------------------------------+
+|fmlticket |現在のチケットシステムのサマリを表示する |
+| |チケットの close |
++------------------+--------------------------------------------------------+
+|fmlticket.cgi |fmlticketの CGI版 |
+| |チケットを closeする。あるチケットに該当する記事群を表 |
+| |示する。 |
++------------------+--------------------------------------------------------+
+|mead |ま〜だだよ |
++------------------+--------------------------------------------------------+
+|fmlserv |ま〜だだよ |
++------------------+--------------------------------------------------------+
+
+</PRE>
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/architecture.html b/fml/doc/ja/htdocs/architecture.html
new file mode 100644
index 00000000..876b6d99
--- /dev/null
+++ b/fml/doc/ja/htdocs/architecture.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml-devel artchitecture
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+<IMG SRC="architecture.gif" ALIGH=CENTER>
+</CENTER>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/built_already.ja.html b/fml/doc/ja/htdocs/built_already.ja.html
new file mode 100644
index 00000000..b37a1d24
--- /dev/null
+++ b/fml/doc/ja/htdocs/built_already.ja.html
@@ -0,0 +1,115 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 で既に動く機能
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+fml5 で既に動く機能
+</CENTER>
+
+<P>
+これらのものは /usr/local/libexec/fml 以下にインストールされます。
+実際には /usr/local/libexec/fml/loader へのリンクです。
+起動される時の名前で振舞いを変えています。
+
+<P>
+注意: fml5 ではすべてのプログラムは /usr/local/libexec/fml/loader を経
+由して起動されます。バージョン依存性を処理するために、つねにこの
+loader を通して起動していくことになっています。
+
+<TABLE BORDER=4>
+ <TR>
+ <TD>
+ fml.pl
+ <BR>
+ distribute
+ <TD> 配送処理をする。
+ subject を書き換える。
+ スプールに記事として溜める。
+ IPv6 をしゃべる。
+ チケット番号をふる。
+ et. al.
+
+ <TR>
+ <TD> command
+ <BR>
+ fml.pl --ctladdr
+ <TD>
+ プログラム自体は動きますが、
+ 機能するコマンドはまだないです。
+
+ <TR>
+ <TD> makefml
+ <TD>
+ 登録と削除関係、および最低限のＭＬの作成だけは動きます
+ (add subscribe
+ <BR>
+ bye unsubscribe resign remove
+ <BR>
+ そして newml)。
+ 使い方は fml 4.0 と一緒です。
+ <BR>
+ % makefml add elena アドレス
+ <BR>
+ % makefml bye elena アドレス
+ <BR>
+ % makefml newml elena
+ <TR>
+ <TD> makefml.cgi
+ <TD> makefml の CGI インターフェイス。
+ うごくけど、まだプロトタイプ。
+ 動く機能は makefml と同等のものです。
+ それは最終的に makefml と同じ関数を呼び出しているからです。
+<PRE>
+例:
+/cgi-bin/makefml.cgi?ml_name=elena&method=bye&address=rudo@nuinui.net
+</PRE>
+
+ <TR>
+ <TD> fmlconf
+ <TD> 変数一覧を表示します
+
+ <TR>
+ <TD> fmldoc
+ <TD> モジュールのマニュアルを表示する
+ <BR>
+ perldoc への wrapper です。
+
+ <TR>
+ <TD> fmlticket
+ <TD>
+ 現在のチケットシステムのサマリを表示する
+ <BR>
+ チケットの close
+
+ <TR>
+ <TD> fmlticket.cgi
+ <TD>
+ fmlticket の CGI 版
+ <BR>
+ チケットを close する。
+ あるチケットに該当する記事群を表示する。
+
+ <TR>
+ <TD> mead
+ <TD>
+ ま〜だだよ
+
+ <TR>
+ <TD> fmlserv
+ <TD>
+ ま〜だだよ
+
+</TABLE>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/components.ja.html b/fml/doc/ja/htdocs/components.ja.html
new file mode 100644
index 00000000..a8e4886f
--- /dev/null
+++ b/fml/doc/ja/htdocs/components.ja.html
@@ -0,0 +1,53 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+コンポーネント
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+<PRE>
+
+ libexec/loader
+ |
+ libexec/process_switch
+ |
+ -------- 乖離層 --------
+ |
+ FML::*
+ Mail::*
+ Jcode:*
+ MIME::*
+
+ MailingList::SMTP
+ IO::*
+
+-------------------------------------------------
+$curproc (current process struct) 構造体のうちわけ
+
+$curproc FML::Process::Kernel オブジェクト
+
+ config FML::Config オブジェクト
+
+ credential FML::Credential オブジェクト
+
+ incoming_message (単なるキーワード)
+ ヘッダ FML::Header オブジェクト
+ メール本文 MailingList::Messages オブジェクト
+
+ article (単なるキーワード)
+ ヘッダ FML::Header オブジェクト
+ メール本文 MailingList::Messages オブジェクト
+
+ reply_messages (単なるキーワード)
+
+</PRE>
+オペレーションは各オブジェクトのメソッドが責任を持って実行する。
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/cvstag.ja.html b/fml/doc/ja/htdocs/cvstag.ja.html
new file mode 100644
index 00000000..55f3b678
--- /dev/null
+++ b/fml/doc/ja/htdocs/cvstag.ja.html
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+改造計画メモ
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+
+<CENTER>
+改造のメモ/ログ
+</CENTER>
+
+<P> 上の方ほど最近のもの
+
+<TABLE>
+
+ <TR>
+ <TD> CVS タグ
+ <TD> 内容
+
+ <TR>
+ <TD>
+ <TD>
+
+ <TR>
+ <TD> mail-message-0-5
+ <TD> mail-message-0-4 の bug fixes 他
+
+ <TR>
+ <TD> mail-message-0-4
+ <TD> mail-message-0-3 以降で、一通り hack した直後のブレークポイント
+
+ <TR>
+ <TD> mail-message-0-3
+ <TD> パーサ部分ももつことにする。FML::Parser は
+ Mail::Message::parse($self, $fd)
+ に統合されるだろう
+
+ <TR>
+ <TD> mail-message-0-2
+ <TD> clean up
+
+ <TR>
+ <TD> new-Mail-class
+ <TD> 基本的にクラス名を MailingList:: から Mail:: へ移行
+
+</TABLE>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/dirhier.ja.html b/fml/doc/ja/htdocs/dirhier.ja.html
new file mode 100644
index 00000000..0ef2b995
--- /dev/null
+++ b/fml/doc/ja/htdocs/dirhier.ja.html
@@ -0,0 +1,54 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+ディレクトリ構造
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<P> 実際にインストールされる場所は、次のような場所と想定されています。
+<PRE>
+/etc/fml/
+/usr/local/lib/fml/$VERSION/
+/usr/local/libexec/fml/$VERSION/
+/usr/share/doc/fml/$VERSION/
+</PRE>
+
+<P> ソース中のディレクトリ構造
+<TABLE BORDER=4>
+ <TR>
+ <TD> ディレクトリ
+ <TD> 説明
+
+ <TR>
+ <TD>
+ <A HREF="index.ja.html" TARGET="_top">fml/doc/</A>
+ <TD>
+ ドキュメント
+
+ <TR>
+ <TD>
+ <A HREF="../etc/index.html"">fml/etc/</A>
+ <TD> 設定変数
+
+ <TR>
+ <TD> <A HREF="../lib/index.ja.html"> fml/lib/ </A>
+ <TD> perl モジュール群
+
+ <TR>
+ <TD> <A HREF="../libexec/boot.ja.html"> fml/libexec/ </A>
+ <TD>
+ 実行されるプログラムの実体。
+ もっともすぐにモジュールを
+ 呼び出すので、正確には wrapper です。
+
+</TABLE>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/download.ja.html b/fml/doc/ja/htdocs/download.ja.html
new file mode 100644
index 00000000..064ac500
--- /dev/null
+++ b/fml/doc/ja/htdocs/download.ja.html
@@ -0,0 +1,50 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 (仮名) のソースの入手方法
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+fml5 (仮名) のソースの入手方法
+</CENTER>
+
+<UL>
+ <LI>
+ <A HREF="ftp://ftp.fml.org/pub/fml-devel/" TARGET="right">
+ ftp://ftp.fml.org/pub/fml-devel/
+ </A>
+
+ <LI>
+ CVS へのアクセス
+
+ <UL>
+ <LI>
+ cvs.fml.org にアクセスできる権限のある人
+<PRE>
+cvs -d cvs.fml.org:/cvsroot co fmlsrc
+</PRE>
+ でアクセスできます(注: cvs over ssh のみがサポートされます)。
+
+
+ <LI>
+ anoncvs.fml.org
+ (ちょっと待ってください。
+ マシンが壊れてしまったのですが、復旧予定不明)
+
+ <LI>
+ <A HREF="http://www.fml.org/cvsweb/fmlsrc/">
+ cvsweb
+ </A>
+
+ </UL>
+</UL>
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/extension.ja.html b/fml/doc/ja/htdocs/extension.ja.html
new file mode 100644
index 00000000..7c3d01f1
--- /dev/null
+++ b/fml/doc/ja/htdocs/extension.ja.html
@@ -0,0 +1,35 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 の拡張の仕方
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+fml5 の拡張の仕方の例
+</CENTER>
+
+<UL>
+
+<LI>
+独自コマンドを作る。
+<BR>
+例えばコマンド uja を作りたいなら、FML::Command をぱくって
+
+ /usr/local/lib/fml/site_local/FML/Command/uja.pm
+
+というファイルを置けば OK (いいのか、それで?)。
+いや、うそかも… 許可するコマンドリストに追加して始めて
+有効になるようにしないといけないと思う。
+
+
+</UL>
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/guide.ja.html b/fml/doc/ja/htdocs/guide.ja.html
new file mode 100644
index 00000000..48ce0081
--- /dev/null
+++ b/fml/doc/ja/htdocs/guide.ja.html
@@ -0,0 +1,177 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+簡単なガイド
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+簡単な設定ガイド
+</CENTER>
+
+注: 特に触れていない概念については fml 4.0 と同じなので、4.0 の資料を
+参照して下さい。
+
+これは動くとはいえ、まだまだ開発者向けのプログラムであることに注意して
+下さい。実運用には
+<A HREF="http://www.fml.org/fml/">fml 4.0</A>
+系を御利用下さい。
+
+<UL>
+ <LI>
+ <A HREF="ftp://ftp.fml.org/pub/fml-devel/" TARGET="right">
+ ダウンロードする。
+ </A>
+
+ <LI>
+ <A HREF="install.ja.html">
+ ユーザ root でインストールをする。
+ </A>
+
+ <LI>
+ <A HREF="#programs"> 使用できるコマンドについて </A>
+
+ <LI>
+ <A HREF="#newml">ユーザ fml で ＭＬを作る。 </A>
+
+ <LI>
+ <A HREF="#config.cf"> カスタマイズをする。 </A>
+</UL>
+
+<HR>
+<A NAME="programs">
+<P> コマンドについて
+<BR>
+
+インストーラは /usr/local/bin に
+
+ fmldoc fmlconf fmlticket makefml
+
+をインストールします。これらは実は /usr/local/libexec/fml の下の実体を
+呼び出す単なる wrapper です。
+
+fmldoc の使い方は perldoc と同様です。fml の任意のモジュールに対しその
+ドキュメントを表示します。
+実のところ perldoc への wrapper です。
+<PRE>
+例:
+% fmldoc FML::Process::Kernel
+</PRE>
+
+fmlconf は引数にＭＬ名をとり、そのＭＬの変数一覧を表示します。
+-n をつけるとデフォルトと異なる変数のみを表示します。
+<PRE>
+例:
+% fmlconf elena
+% fmlconf -n elena
+</PRE>
+
+fmlticket は引数にコマンドとＭＬ名をとります。
+チケットシステムへのインターフェイスです。
+まだ製作途中です。
+<PRE>
+例: close されていないチケット一覧を表示
+% fmlticket list elena
+
+例: チケットを close する。
+% fmlticket close elena チケット番号
+</PRE>
+
+makefml の使い方は fml 4.0 の makefml と同様です。
+現在使えるコマンドは以下のものだけです。
+<UL>
+ <LI>メンバーの登録
+ <LI>メンバーの削除
+ <LI>ＭＬの作成( newml )
+</UL>
+
+
+<HR>
+<A NAME="newml">
+<P> ＭＬを作る
+
+fml 4.0 と同様です。
+が、config.cf という設定ファイルをインストールしてくれるだけです。
+<PRE>
+% su fml
+% makefml newml elena
+% ls /var/spool/ml/elena
+config.cf
+</PRE>
+
+とりあえず config.cf の先頭の ml_domain と ml_name を
+自分のＭＬに変更して下さい。
+まだ自動変換できません（そのうちします）。
+<PRE>
+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
+</PRE>
+
+
+include include-ctl aliases も fml 4.0 と同様です。
+が、まだ、makefml newml で自動生成できるようになっていません _o_
+
+/var/spool/ml/elena/include ファイルは
+<PRE>
+"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena"
+</PRE>
+
+/var/spool/ml/elena/include-ctl ファイルは
+<PRE>
+"| /usr/local/libexec/fml/fml.pl /var/spool/ml/elena --ctladdr"
+</PRE>
+
+aliases への追加は次のようにして下さい。
+<PRE>
+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
+</PRE>
+
+
+<HR>
+<A NAME="config.cf">
+<P> カスタマイズをする
+
+elena ＭＬの設定のカスタマイズは /var/spool/ml/elena/config.cf を編集
+して下さい。フォーマットは fml 4.0 の cf に近いですが、postfix の設定
+ファイルと同様です。
+
+必要な項目を追加して下さい。それ以外はデフォルト値が使われます。
+デフォルト値はインストールしたバージョンに依存し、
+<PRE>
+/etc/fml/defaults/バージョン番号/default_config.cf
+</PRE>
+というファイルで定義されています。
+これは perl のライブラリが /usr/local/lib/perl/5.00503/ のように
+バージョン番号付のディレクトリに置かれるのと同様です。
+
+インストールした fml のバージョンごとに全部別のディレクトリに
+置かれることに注意して下さい。
+この仕組みのおかげでアップグレードしても元に戻すのが簡単です。
+
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/index.ja.html b/fml/doc/ja/htdocs/index.ja.html
new file mode 100644
index 00000000..2c969fd5
--- /dev/null
+++ b/fml/doc/ja/htdocs/index.ja.html
@@ -0,0 +1,21 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml 5 project home page
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<FRAMESET COLS="25%,*" BORDERSPACING=0 FRAMEBORDER=0 BODER=0 BORDERCOLOR="#E6E6FA">
+ <FRAME SRC="menubar.ja.html" NAME="left">
+ <FRAME SRC="purpose.ja.html" NAME="right">
+ <NOFRAMES>
+ <A HREF="purpose.ja.html">
+ fml5 project objects
+ </A>
+ (if your browser not support frameset).
+ </NOFRAMES>
+</FRAMESET>
+</HTML>
diff --git a/fml/doc/ja/htdocs/install.ja.html b/fml/doc/ja/htdocs/install.ja.html
new file mode 100644
index 00000000..8636fd21
--- /dev/null
+++ b/fml/doc/ja/htdocs/install.ja.html
@@ -0,0 +1,71 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+00_README.ja.txt
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<PRE>
+ インストールについて
+
+ * 用語について:
+ % 一般ユーザのプロンプト
+ # ユーザ root のプロンプト
+ fml 4 ( fml 4.0 シリーズのこと )
+
+
+対話型インストーラなどは"まだ"作られていません。
+
+トップ・ディレクトリにある INSTALL.sh の先頭にあるディレクトリ名などを
+適当に修正し、root で実行して下さい。
+
+ % su root
+ # sh INSTALL.sh
+
+それぞれのディレクトリの役割は次の通りです。
+
+/etc/fml
+
+ 基本設定ファイルを置く場所。
+ ( fml 4 の /usr/local/fml/.fml や default_config.ph 相当)
+
+ バージョンやライブラリの場所(ディレクトリ)などを指定する。
+
+
+/usr/local/libexec/fml
+
+ 実行ファイル ( fml 4 の /usr/local/fml )
+
+
+/usr/local/lib/fml
+
+ ライブラリ ( fml 4 の /usr/local/fml )
+
+
+/var/spool/ml
+
+ ＭＬのホームディレクトリ。fml 4 と同じ目的です。
+
+ 注意: /var/spool/ml のオーナは INSTALL.sh の
+ owner 変数(デフォルトはユーザ fml)に設定されます。
+
+
+○ ドキュメントは HTML 版だけです。
+
+トップ・ディレクトリにある index.ja.html からたどっていってください。
+
+
+○ elena ＭＬの設定の見方
+
+ 全部の変数を表示する
+ /usr/local/libexec/fml/fmlconf elena
+
+ デフォルト値と異なる変数を表示する
+ /usr/local/libexec/fml/fmlconf -n elena
+</PRE>
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/mailinglist.ja.html b/fml/doc/ja/htdocs/mailinglist.ja.html
new file mode 100644
index 00000000..d9e4a04f
--- /dev/null
+++ b/fml/doc/ja/htdocs/mailinglist.ja.html
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 (仮名) プロジェクトのメーリングリスト
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+fml5 (仮名) プロジェクトのメーリングリスト
+</CENTER>
+
+<PRE>
+fml 5 の議論のためのメーリングリストを用意してあります。
+投稿用のアドレスは
+
+<address>fml-devel@ffs.fml.org (日本語)</address>
+
+です。fml-devel ＭＬのログは
+<A HREF="http://www.fml.org/mlarchives/">
+http://www.fml.org/mlarchives/
+</A>
+で公開しています。
+
+ＭＬに参加しないが、要望等を送りたいという場合、ＭＬではなく
+
+<address>fml-request@fml.org</address>
+
+へメールを送って下さい。このメールは適宜 fml-devel 等に流して議論した
+いと思います。他にフォワードなどされたくない場合はその旨を一筆書いてお
+いて下さい。
+
+
+<P> <B>登録の仕方</B>
+<BR>
+
+登録の仕方はいつもと一緒です。
+
+fml-devel MLへの自動登録は fml-devel-ctl@ffs.fml.org へ
+subscribe の後に自分の名前をローマ字で続けたフレーズをメールの"本文"
+(注意: メールの本文)に書いて送って下さい。例えば次のようになります。
+<PRE>
+ To: fml-devel-ctl@ffs.fml.org
+
+ subscribe Kinomoto Sakura
+</PRE>
+このメールに対し、登録意志確認のメールが送り返されてきます。
+そのメールに返事をしてください。
+ＭＬに登録されます。
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/menubar.ja.html b/fml/doc/ja/htdocs/menubar.ja.html
new file mode 100644
index 00000000..05cd80d0
--- /dev/null
+++ b/fml/doc/ja/htdocs/menubar.ja.html
@@ -0,0 +1,151 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 (仮称) documents メニュー
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+
+既に叩き台のある部分
+
+<UL>
+ <LI>
+ <A HREF="download.ja.html" TARGET="right">
+ ソースの入手方法
+ </A>
+
+ <LI>
+ <A HREF="install.ja.html" TARGET="right">
+ インストール
+ </A>
+ <BR>
+ <A HREF="upgrade.ja.html" TARGET="right">
+ アップグレード
+ </A>
+
+ <LI>
+ <A HREF="mailinglist.ja.html" TARGET="right">
+ メーリングリスト
+ </A>
+ <BR>
+ <A HREF="http://www.fml.org/mlarchives/fml-devel/" TARGET="right">
+ 過去ログ
+ </A>
+
+ <LI>
+ <A HREF="guide.ja.html" TARGET="right">
+ 設定ガイド
+ </A>
+
+ <LI>
+ <A HREF="built_already.ja.html" TARGET="right">
+ 既に動くプログラム
+ </A>
+ <BR>
+ <A HREF="../lib/FML/Process/programs.ja.html" TARGET="right">
+ 対応するモジュール
+ </A>
+
+ <LI>
+ モジュール
+ <BR>
+ <A HREF="terms.ja.html" TARGET="right">
+ 用語集
+ </A>
+ <BR>
+ <A HREF="../lib/index.ja.html" TARGET="right">
+ fml.org 管轄
+ </A>
+ <BR>
+ <A HREF="../../cpan/dist/index.html" TARGET="right">
+ CPAN からの輸入
+ </A>
+
+ <LI>
+ <A HREF="../libexec/index.ja.html" TARGET="right">
+ libexec/ (fml.org 管轄)
+ </A>
+
+ <LI>
+ <A HREF="../libexec/boot.ja.html" TARGET="right">
+ fml のブートの様子
+ </A>
+
+ <LI>
+ <A HREF="../../hier.ja.html" TARGET="right">
+ CVS のトップ階層
+ </A>
+
+ <LI>
+ 変数
+ <BR>
+ <A HREF="../etc/defaults/naming_convention.ja.html" TARGET="right">
+ 命名規則
+ </A>
+ <BR>
+ <A HREF="../etc/defaults/variablelist.ja.html" TARGET="right">
+ デフォルト値一覧
+ </A>
+
+ <LI>
+ <A HREF="extension.ja.html" TARGET="right">
+ fml5 の拡張例
+ </A>
+
+ <LI>
+ <A HREF="cvstag.ja.html" TARGET="right">
+ CVS タグと更新履歴
+ </A>
+</UL>
+
+
+<EM>構想</EM>
+<UL>
+ <LI>
+ <A HREF="announce.ja.html" TARGET="right">アナウンス</A>
+
+ <LI>
+ <A HREF="purpose.ja.html" TARGET="right">
+ 目的
+ </A>
+
+ <LI>
+ <A HREF="refactoring.ja.html" TARGET="right">
+ アイデアのまとめ
+ </A>
+
+ <LI>
+ <A HREF="components.ja.html" TARGET="right">
+ コンポーネント指向
+ </A>
+
+ <LI>
+ <A HREF="architecture.html" TARGET="right">
+ アーキテクチャ
+ </A>
+
+ <LI>
+ <A HREF="style.ja.html" TARGET="right">
+ プログラミングスタイル
+ </A>
+
+ <LI>
+ <A HREF="dirhier.ja.html" TARGET="right">
+ ディレクトリの階層構造
+ </A>
+
+ <LI>
+ <A HREF="releng.ja.html" TARGET="right">
+ リリース計画
+ </A>
+</UL>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/purpose.ja.html b/fml/doc/ja/htdocs/purpose.ja.html
new file mode 100644
index 00000000..f0674e3a
--- /dev/null
+++ b/fml/doc/ja/htdocs/purpose.ja.html
@@ -0,0 +1,136 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 (仮名) プロジェクトの目的
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+fml5 プロジェクトの目的
+</CENTER>
+
+<P>
+このページ群 (
+ <A HREF="http://www.fml.org/devel/">http://www.fml.org/devel/</A>
+)
+は将来の fml-current についてのデザインや実装例を紹介しています。
+おおまかにいえば fml 4.0 の再構想(refactoring)です。
+
+<P>
+これは fml 5.0 のアイデアを募るための、
+<EM>fml 5.0 のアルファ版のアルファ版のアルファ版</Em>
+もしくは
+<EM>プロトタイプ</EM>
+とでもいうべきものです。ですが、すでに動く実装例をダウンロードできます
+し、fml 1.2 相当の機能を使うこともできます。しかしながら、変数名もアー
+キテクチャアも本決まりではないので、将来変わる可能性があります。
+
+<P>
+また、多くの機能が実装されていません。これは、デザインを最初から考え直
+すに当たり、アイデアや意見を募集するためにまだまだ原型にとどまっている
+ためでもあります。
+
+<P>
+ものによっては fml 5.0 用に作られたモジュールを fml 4.0 へ
+輸入/輸出することも検討しています。
+たとえば 4.0 でも独立性の高い mead (エラーメール解析プログラム)などは
+その良い例だろうし、新機能を提供するモジュールなども再輸入(輸出)可能な
+ものは順次マージしていきます。
+
+<P>
+これらのマージおよび 4.0 自体のコードの保守をしつつ 4.0 および 5.0 は
+並行開発されていく予定です。
+そのため 4.0 系は stable に近い current という位置付けになります。
+そして 4.0 の bug fix は 4.0.x (4.0.1 4.0.2 …)としてまとめられリリー
+スれていく予定です。
+逆に 5.0 は本当の開発用のコード( fml-current )ということになります。
+<PRE>
+ -----------------------------> 5.0 (本プロジェクトの目標)
+ ↑↓交流
+1.2 〜 4.0 ------------------------------> 4.0-current
+ | |
+ 4.0.1 4.0.2 .... (リリース / 4.0-stable バージョン)
+</PRE>
+
+<P>
+5.0 のアイデアのついて、ご意見・御感想をお待ちしております。
+端的にいえば 4.0 のここは受け継ぎたいが、あの機能は
+どうでもよいとか、あの機能はこう実装するべきだなどといった
+意見も募集しています。
+
+
+<HR>
+
+<UL>
+ <LI>
+ <A HREF="refactoring.ja.html">
+ おおざっぱまな構想
+ </A>
+
+ <LI>
+ 設定ファイルとメニュープログラムの負荷を少なくしたい
+
+ <LI>
+ 全部 perl module 形式 (要 5.004 以降)
+
+ <LI>
+ CUI (makefml) インターフェイスおよび CGI インターフェイス
+ <BR>
+ これは従来通りのもの。
+ <BR>
+ ただしより統合化され、
+ よりメニューなどが書きやすいものであるように
+ (実装者が楽できる設定ファイル形式がのぞましい et.al.)
+
+ <LI>
+ 乖離層
+ <UL>
+ <LI> バージョンアップを簡単にできるように
+ <LI> CPAN モジュール使いまくり
+ <BR>
+ (ただし、できるだけ直接使うより、
+ 一層被せておくほうがよい)
+ <LI> 3rd party 用ディレクトリ
+ </UL>
+
+ <LI>
+ 統一化されたメンバーリストなどへのアクセスをできるだけ抽象化する。
+ <UL>
+ <LI> ファイル (実装済み)
+ <LI> /etc/group (実装済み)
+ <LI> NIS (実装済み)
+ <LI> SQL (プロトタイプは実装済み)
+ <LI> LDAP
+ <LI> SSRP (?)
+ </UL>
+ 実際には効率の問題もあり、
+ あらゆる抽象化は重たくなってしまう。
+ しかし少々重くなっても実装しよう。
+
+ <LI>
+ <A HREF="releng.ja.html">
+ 新リリースエンジニアリング
+ </A>
+
+ <LI>
+ IPv4/IPv6 ready (実装済み)
+
+ <LI>
+ ドキュメントは SGML で DTD は docbook (か?)
+</UL>
+
+<!-- =================================================================== -->
+
+<CENTER>
+アーキテクチャア・イメージ
+<IMG SRC="architecture.gif" ALIGH=CENTER>
+</CENTER>
+
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/refactoring.ja.html b/fml/doc/ja/htdocs/refactoring.ja.html
new file mode 100644
index 00000000..319a26cd
--- /dev/null
+++ b/fml/doc/ja/htdocs/refactoring.ja.html
@@ -0,0 +1,145 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+fml5 [ fml リファクトリング プロジェクト (Refactroing Project) ]
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+
+<CENTER>
+fml5 [ fml リファクトリング プロジェクト (Refactroing Project) ]
+</CENTER>
+
+<P> いくつかのアイデア
+
+<TABLE BORDER=4>
+ <TR>
+ <TD> status
+ <TD> <EM>項目</EM>
+ <TD> 備考
+
+ <TR>
+ <TD>
+ <TD> <EM>ライセンス</EM>
+ <BR>
+ ライセンスを Perl 準拠へ変更する
+ <TD>
+
+ <TR>
+ <TD>
+ <TD> <EM>イメージ/モティーフ</EM>
+ <BR>
+ fml4 から fml5 へは、sendmail から postfix への移行のようなイメージで
+ <BR>
+ 最低限の config.ph コンバータは用意する。
+
+ <TR>
+ <TD>
+ <TD>
+ <EM> メインプログラムの wrapper (乖離層) </EM>
+ バージョン管理やデバッグを簡単にするための乖離層
+ <PRE>
+ fml.pl ---> /etc/fml/main.cf
+ ---> libexec/loader
+ ---> lib/$VERSION/プロセス切替えモジュール
+ ---> lib/$VERSION/モジュール
+ </PRE>
+
+ <TR>
+ <TD>
+ <TD>
+ <EM>再利用性</EM>
+ <BR>
+ 自主開発はできるだけ避ける。
+ <BR>
+ 可能な限りあらゆる CPAN モジュールなどを使う。
+ そして利用する場合には乖離層を設けること。
+ <PRE>
+ FML::モジュール → 乖離層 → CPAN/モジュール
+ </PRE>
+ <TD>
+ <A HREF="style.ja.html">プログラミングスタイル</A>
+
+ <TR>
+ <TD>
+ <TD> <EM>設定ファイル形式</EM>
+ <UL>
+ <LI> cf と config.ph を統合化する
+ <LI> 配列を表現できる形式
+ <LI> メニュープログラムが楽できるフォーマットを
+ <LI> 原則として”設定ファイル”という名のものは
+ どれも同じフォーマットとする。
+ </UL>
+ <TD>
+
+ <TR>
+ <TD>
+ <TD>
+ <EM>
+ <A HREF="../etc/defaults/naming_convention.ja.html">
+ 変数の命名規則
+ </A>
+ </EM>
+ <UL>
+ <LI> USE_機能
+ <LI> 機能_TYPE
+ <LI> 機能_ATTRIBUTES
+ </UL>
+ <BR>
+ ”USE_ほえ”および”ほえ_TYPE”形式か？
+ また、NOT_USE などは禁止する( default_config に書くこと)。
+ <BR>
+ attribute にあたるものが
+ 群れになってしまうのはしょうがない。しかし、
+ 配列表現が可能なため、現在の ifdef の群れで表現する
+ ようなことが少なくなるはず。
+
+ <TR>
+ <TD>
+ <TD>
+ <EM> 関数名ルールの統一 </EM>
+ <BR>
+ main:: スペースに出てくるものは従来通り X11 風準拠に。
+ メソッドは他のモジュールにあるようなそれっぽい小文字の名前をつける。
+ lisp 的要素を廃止する。
+ 参考文献 Perl Cookbook として、
+ そこにあるようなシンタックス風を推奨する？
+ <BR>
+ 例:
+ メソッドなら is_member() で、大域関数なら
+ <PRE>
+ MemberP() -> IsMember()
+ </PRE>
+
+
+ <TR>
+ <TD>
+ <TD>
+ <EM> queue manager </EM>
+ <BR>
+ 再送処理のため (e.g. smtpfeed )
+
+ <TR>
+ <TD>
+ <TD>
+ <EM> tools </EM>
+ <BR>
+ BSD make を使わない。
+ <BR>
+ C 言語ではないので、autoconf は特には必要ないと思う。
+ しかしながら configure という名前のスクリプトを（フェイクでも）
+ 用意することはよいことかもしれない。
+ そのスクリプトは例えば
+ IPv6 ready か否かを決めるために使われるだろう(
+ 現在の実装では使ってはいない、IPv6 は常に挑戦してみる
+ )。
+
+</TABLE>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/releng.ja.html b/fml/doc/ja/htdocs/releng.ja.html
new file mode 100644
index 00000000..6eb0613e
--- /dev/null
+++ b/fml/doc/ja/htdocs/releng.ja.html
@@ -0,0 +1,55 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+リリース・エンジニアリングについて
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+リリース・エンジニアリングについて
+</CENTER>
+
+<P>
+ アーキテクトでも、デベロッパーに偏ってもいけない。
+ 抽象化に萌過ぎても、オブジェクト指向分析に燃え過ぎてもいけない。
+ 中庸であり、一カ月単位でフィードバックしながら
+ プロジェクトの計画とコードレビューを行なうこと。
+
+
+<P> 月単位でのリリースエンジニアリングの原案
+
+<TABLE>
+ <TR>
+ <TD> 最初の 4〜5日
+ <TD> 計画を練り直す。
+ <BR>
+ リリースエンジニアリングプロセス中の
+ 20 ％程度はこの計画に費やすこと
+
+ <TR>
+ <TD> 2〜3 週間
+ <TD> コードを書く
+
+ <TR>
+ <TD> 最終週
+ <TD> ドキュメントを見直す、およびコードレビュー
+
+ <TR>
+ <TD> 月の切れ目
+ <TD> まぁまぁ大丈夫ぽい snapshot を出してみる。
+ alpha-0,
+ alpha-1,
+ alpha-2, ...
+
+</TABLE>
+
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/style.ja.html b/fml/doc/ja/htdocs/style.ja.html
new file mode 100644
index 00000000..39c89a6e
--- /dev/null
+++ b/fml/doc/ja/htdocs/style.ja.html
@@ -0,0 +1,67 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+プログラミング・スタイル
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+プログラミング・スタイル (原案のメモ(注: 単なる走り書き))
+</CENTER>
+
+<P> <EM>基本的なスタイル</EM>
+<UL>
+ <LI>
+ Perl ではポリモーフィズムと実行時バインディングができることに
+ は重視すること。多重継承などに頭を使うより
+ ポリモーフィズムと実行時バインディングによる
+ コンポーネント指向ぽい方向性を模索する。
+
+ <LI>
+ Perl 5 のパッケージを使った、オブジェクトぽい書き方は
+ 変数自身が自分のパッケージを知っているので、
+ 単にパッケージ修飾(例: :: )を使わなくてもよいくらいに
+ 思う方がよい。
+
+ <LI>
+ そのために、
+ 再利用性と抽象度を高くしたインターフェイスは
+ オブジェクトぽい書きかたが良さそう。
+
+ <LI>
+ perl 5 だと必然的にオブジェクトぽくなってしまうが、
+ オブジェクト、オブジェクト、オブジェクトし過ぎないように
+ バランス感覚に注意しよう。
+
+ <LI>
+ 他人のモジュールを使う場合はともかく、
+ 自分達で書くモジュールでの
+ ”深い”継承はできるだけ避けたい。
+ 何でも深くすればよいというものではないでしょう。
+</UL>
+
+<P> <EM>メイン → モジュールの基本的な形の例:</EM>
+ libexec/ や libkern.pl にある関数は、
+ main:: に記述される部分は基本的なフローを記述している。
+ これらは基本的な枠組を示すものであるため、
+ $CurProc (C でいえば struct *curproc にあたるもの)
+ を受け渡す、構造化プログラミング的な書き方をしている。
+ <PRE>
+
+ </PRE>
+
+<P> <EM>モジュール → モジュール </EM>
+ <BR>
+ しかし、そのひとつ下の層、そしてさらにその下では、
+ 再利用性とポリモーフィズムに傾いた方がよさそうにおもえる。
+
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/terms.ja.html b/fml/doc/ja/htdocs/terms.ja.html
new file mode 100644
index 00000000..bb461ee9
--- /dev/null
+++ b/fml/doc/ja/htdocs/terms.ja.html
@@ -0,0 +1,110 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+関数名および変数名に関連した用語のまとめ
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<!-- ================== body =========================================== -->
+
+<CENTER>
+関数名および変数名に関連した用語のまとめ
+</CENTER>
+
+<TABLE BORDER=4>
+ <TR>
+ <TD> 用語/単語の省略形
+ <TD> 説明
+
+ <TR>
+ <TD> fml 4
+ <TD> fml 4.0 シリーズのこと
+
+ <TR>
+ <TD> fml 5
+ <BR>
+ fml-devel
+ <TD> 遠い将来に
+ fml 5.0 になるであろうとおもわれる fml-current
+
+ <TR>
+ <TD> curproc
+ <TD> "current process"の略
+
+ <TR>
+ <TD> PCB
+ <TD> Process Control Block の略。
+ そのプロセス固有の情報を含む。
+ 現状 fml 内部でのコンテキスト切替などはないので、
+ UNIX カーネルの PCB とは少し趣が異なります。
+
+ <TR>
+ <TD> config
+ <TD> configuration の略
+
+ <TR>
+ <TD> arg <BR> args
+ <TD> アーギュメントの略
+
+ <TR>
+ <TD> fh
+ <TD> ファイルハンドル( file handle )
+
+ <TR>
+ <TD> dh
+ <TD> ディレクトリハンドル( directory handle )
+
+ <TR>
+ <TD> fp
+ <TD> 関数へのポインタ( function pointer )
+ <BR>
+ ただし perl では CODE リファレンスと呼ぶべき
+
+ <TR>
+ <TD> _なになに
+ <TD> 慣習的にパッケージ、クラス、オブジェクト内部で使う
+ 変数や関数名に _ ではじまるキーワードを使う。
+
+ <TR>
+ <TD> rなになに
+ <TD> r はリファレンスの略。ハンガリアン記法
+ <BR>
+ 特別に強調したい場合に使うことがあるが、
+ あまり使っていない。
+
+ <TR>
+ <TD> STR
+ <TD> 文字列 ( string ) の略
+
+ <TR>
+ <TD> 日本語コードの略称
+ <TD> JIS SJIS EUC などおなじみのもの…
+
+ <TR>
+ <TD> 2
+ <TD>
+ to と発音が一緒のため省略形としてよく使う。
+ 類似品として 4 ( for の意味)もある
+ <BR>
+ 例: STR2EUC (STRing to EUC の略)
+ <BR>
+ <PRE>
+ use String qw(STR2EUC);
+ $euc_string = &STR2EUC($string);
+ </PRE>
+
+ <TR>
+ <TD> 4
+ <TD> for と発音が同じために用いる。
+ <BR>
+ 例: まだなし
+
+</TABLE>
+
+<!-- =================================================================== -->
+</BODY>
+</HTML>
diff --git a/fml/doc/ja/htdocs/upgrade.ja.html b/fml/doc/ja/htdocs/upgrade.ja.html
new file mode 100644
index 00000000..1021187f
--- /dev/null
+++ b/fml/doc/ja/htdocs/upgrade.ja.html
@@ -0,0 +1,60 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+<TITLE>
+on upgrade installation
+</TITLE>
+<META http-equiv="Content-Type"
+ content="text/html; charset=EUC-JP">
+</HEAD>
+
+<BODY BGCOLOR="#E6E6FA">
+<PRE>
+ アップグレードについて
+
+ * 用語について:
+ % 一般ユーザのプロンプト
+ # ユーザ root のプロンプト
+ fml 4 ( fml 4.0 シリーズのこと )
+</PRE>
+
+普通に<A HREF="install.ja.html">インストール</A>してください。
+
+インストール後、/etc/fml/main.cf の fml_version 行の日付を
+最新のものにして下さい。
+
+ファイルをセーブした瞬間から新しい fml に切り替わります
+(注: エディタで編集中は古い内容)。
+
+<HR>
+<P><H4>注意点</H4>
+
+<UL>
+<LI>
+Q: loader や Bootstrap() がどーとかいうエラーが出る
+<BR>
+A: ブートストラップのやり方がまだ収束してないので、稀に
+<BR>
+
+ /usr/local/fml/libexec/loader
+
+を入れ替える必要がある時があります。loader は /etc/fml/main.cf を読む
+前に起動されるものなので、手動で切替えるしかない。
+
+やりかたはインストール後に、
+
+ # /usr/local/fml/libexec/
+ # mv current-yyyymmdd/loader loader
+
+などとする。cp でもいいけど同一パーティッション上の mv なら atomic で
+あることが保証されるので、good 。
+
+
+<LI>
+Q: アップグレードしたがうまく動かないので、元に戻したい
+<BR>
+A: /etc/fml/main.cf の fml_verison をアップグレード前のものに
+ 戻して下さい。
+</UL>
+</BODY>
+</HTML>
generated by cgit v1.2.1 (git 2.18.0) at 2026-09-08 00:03:34 +0000