[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[b-free: 2062] サブプロジェクト実装指針
隆一です。
えーと、以前の議論でもありましたが、サブプロジェクトの担当者が実装する
にあたって、BTRON 仕様にどのくらい従うべきなのかという指針を考えてみま
した。いろいろご意見をいただければ幸いです。
もし、おかしいところがないようでしたら、Web の方へ出しておきます。
(といっても、まだ tron-net.gr.jp は動いていないみたいですが……)
-------------------
B-Free サブプロジェクト実装指針
1998年9月8日(火)
内藤隆一 (night@tron-net.gr.jp)
1) B-Free OS (およびサブシステム)は、原則として BTRON 仕様 *1) および
TRON HMI 仕様 *2) に従う。
ただし、BTRON 仕様書の記述のうち、実装上の記述(各マネージャの構造等)
については従う必要はない。API 上の動作(イベントの取得時の動作等)に
ついては API 仕様に含むこととする。
2) BTRON 仕様に記述のない部分については、実装者が自由に内容を決めてよい。
各マネージャ/コンポーネントの実装方法については、BTRON 仕様の記述に
関わらず、実装者が自由に内容を決定できる。
この考えは、モジュール構成についても同様である。
3) BTRON 仕様のうち問題(実装するのが難しい、仕様自体がおかしい)がある
部分については、実装者の判断によって改良してもよい。
ただし、上下層のインタフェース部分に対して影響がある場合は、B-Free
ML などにより上下層のモジュールの実装者に同意を得る事を推奨する。
(同意は必須ではない)
これらの改良は、可能な限り各モジュールへの影響を最小限に留める事。
既存 API の変更については、上位互換を推奨する。
4) BTRON 仕様から逸脱/拡張する場合、なるべくその変更後の仕様を実装者は
記述/公開すること(最低限、拡張した仕様のリストは公開して欲しい)。 *3)
なお、あなたがアプリケーションプログラムを書く上で API を拡張して欲し
い、あるいは自分で拡張したのでプログラムにマージして欲しいならば、サブ
プロジェクトを管理している人に連絡して欲しい。
運がよければ、API に新しい機能が加わることになる。ただし、要求したから
といって、新しい機能が入るとは限らない。その場合、アプリケーションプロ
グラム側で対応することを検討して欲しい。多くの人が必要としている機能な
らば、新しく入る可能性が高い(が、もちろん確実というわけではない)。
サブプロジェクトでの選択が不満な人は、その部分を独自に作成して、対案の
有効性を示せば、その修正が入る可能性は高い。
*1) BTRON 仕様は、以下の文書の順序で従う(記述が矛盾している場合には、
上の仕様書の記述に従う):
o BTRON3 仕様書
o BTRON1 仕様ソフトウェア仕様書
o BTRON1 標準プログラミングハンドブック
*2) TRON HMI 仕様は、以下の文書に従う(記述が矛盾している場合には、
上の仕様書の記述に従う)
o トロン電脳生活ヒューマンインタフェース標準ハンドブック
o BTRON3 仕様書
o BTRON1 仕様ソフトウェア仕様書
o BTRON1 標準プログラミングハンドブック
*3) B-Free ML または B-Free API サブプロジェクト宛にメイルを出せば
自動的に B-Free API に追加される(これは、API を変更するというメイ
ルを受けつけるのであって、API を変更して欲しいというメイルについて
ではないことに注意)。
以上
-------------------
3) については、B-Free ML で議論して決めればいいという人もいるかもしれ
ません。しかし、ML 上の議論だと結論が出るとは限らない、また出た結論が
最適なものとはないときに軌道修正が難しい(責任者が不明確になりやすいか
ら)というように思うので実装者の判断に任せることにしました。もちろん、
実装者が ML で意見を募集/議論することは有りです。結論を多数決で決める
ことを避けたいというだけです。
なお、この指針を書くにあたって、以下の方々からのご意見を参考にしました。
(ありがとうございます)もし、リストから漏れている人がいましたら、連絡し
てください。
Yasushi Shoji (yashi@yashi.com)
Hideaki Suzuki (h1suzuki@bridgew.edu)
Masayuki Okada (masayuki@fa2.so-net.ne.jp)
Hidekazu SHIOZAWA / 塩澤秀和 (shiozawa@mos.ics.keio.ac.jp)
p----------------------------------------------------------------------q
| FROM R.Night |
| E-mail: |
| rnaitoh@st.rim.or.jp |
| Key fingerprint = 89 EB 77 95 40 C0 3C CC 37 A1 A7 FA 1C 66 FF D0 |
b----------------------------------------------------------------------d