Develop and Download Open Source Software

Hyper Operating System(ITRON仕様OS)

Browse CVS Repository

/[OSDN]/hos/policy/policy.txt

Annotation of /hos/policy/policy.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph

Revision 1.3 - (hide annotations) (download)
Sun Jul 21 12:14:05 2002 UTC (21 years, 8 months ago) by ryuz
Branch: MAIN
Changes since 1.2: +8 -7 lines
File MIME type: text/plain 
modify to typemiss
1 ryuz 1.1 ------------------------------------------------------------------------------
2     Project HOS 開発ポリシー（草案）
3    
4 ryuz 1.2 Copyright (C) 2002 by Project HOS
5 ryuz 1.1 ------------------------------------------------------------------------------
6    
7    
8    
9 ryuz 1.2 1. 概要
10 ryuz 1.1
11 ryuz 1.3 本文書は Project HOS の活動における、開発ポリシーの総則です。
12 ryuz 1.2 プロジェクト固有のポリシーは別途定めるものとしますが、各プロジェクトの
13     開発ポリシーに記載の無い部分は暗黙的に本文書に従うものとします。
14 ryuz 1.1
15    
16 ryuz 1.2
17     2. Project HOS について
18    
19     2.1. 概要
20    
21     本プロジェクトは Hyper Operating System(以下 HOS と記載）を核とする、
22     組み込みソフトウェア開発者が有志で集い活動しているものです。
23     SourceForge.jp にて集団開発を行っていくにあたり、「Project HOS」との
24     名称で、開発グループを結成いたしました。
25     プロジェクトの趣旨にご賛同いただける方は誰でも参加頂くことが可能です。
26    
27    
28     2.2. プロジェクトの目的
29    
30     本プロジェクトは、誰もが自由に利用できる ITRON を開発することで、
31     組み込み産業界及び、個人で楽しむ多くの方々に対して社会貢献を行うことと、
32     メンバーのスキルアップを目的とします。
33    
34    
35     2.3. 各人のポリシーの尊重
36 ryuz 1.1
37     オープン開発の性格上、いろいろな個人的ポリシーを持った方に参加いただく事に
38     なると思いますし、そうなって欲しいと願っております。
39     それに際して、ポリシーの違いから議論が起こることも当然ありえると思います。
40     技術者として、個人のポリシーと本分があるのは当然ですので、そのような場合は
41     是非有用な議論として発展させ、より良い形で全員にフィードバックされるよう
42 ryuz 1.3 各自お互いを尊重するよう心がけるものと致します。
43 ryuz 1.1
44    
45 ryuz 1.2 2. 運用ルール
46 ryuz 1.1
47     2.1. ファイル名について
48    
49 ryuz 1.2 本プロジェクトの開発の多くは、UNIX系、Windows系などクロスプラットフォーム
50     をターゲットにしています。
51     従いまして、クロスプラットフォーム対応における問題回避のため最低限の
52 ryuz 1.3 ルールを定めます。
53 ryuz 1.2
54    
55     2.2.1. 総則
56    
57 ryuz 1.3 CVSからのチェックアウトを問題なく行うための最低限のルールとして、
58     以下のことを定めます。
59 ryuz 1.1
60     ・ファイル名に漢字(2byteコード）は利用しない
61 ryuz 1.3 ・大文字小文字を区別出来ないファイルシステムで衝突が生じるファイル
62     を同一ディレクトリに置かない(例: Makefileとmakefile)
63 ryuz 1.2 ・環境依存のある文字は利用しない
64     ・空白文字も可能な限りファイル名に含めない
65 ryuz 1.1
66    
67 ryuz 1.2 2.2.2. DOS向けのファイル
68 ryuz 1.1
69 ryuz 1.2 MS-DOS用のツールに入力する可能性があるものに関してはさらに以下の
70     るルールを定めます。
71 ryuz 1.1
72 ryuz 1.2 ・ファイル名は小文字に統一する
73     ・8+3形式に統一する
74 ryuz 1.1
75    
76 ryuz 1.2 2.2.3. Windows向けのファイル
77 ryuz 1.1
78 ryuz 1.2 総則に反しない限り、Windows文化に合わせてよいものとします。
79     即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を
80     きたさない範囲とします。
81 ryuz 1.1
82    
83 ryuz 1.2 2.2.4. UNIX系向けのファイル
84 ryuz 1.1
85 ryuz 1.2 総則に反しない限り、UNIX文化に合わせてよいものとする。
86     即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を
87     きたさない範囲とします。
88     UNIX系の場合、実行可能属性などは適切に設定することとします。
89 ryuz 1.1
90    
91 ryuz 1.2 2.2.5. ソースファイルからの参照について
92 ryuz 1.1
93 ryuz 1.2 例えば C言語の #include ディレクティブなど、ソース中で
94     ファイル名を利用する場合、例えば、Windows環境で Sample.h
95     を #include "sample.h" としてもエラーになりませんが、UNIX環境では
96     大文字／小文字を区別するためファイルが見つからずコンパイル
97     エラーとなります。
98     クロス環境で利用可能なソースについては、Windows環境でも
99     気をつけて扱うよう心がけてください。
100 ryuz 1.1
101    
102 ryuz 1.2 2.3. 文字コードについて
103 ryuz 1.1
104 ryuz 1.2 2.3.1. 総則
105 ryuz 1.1
106 ryuz 1.2 原則として CVS リポジトリに含めるテキストファイルは EUC
107     文字コードとし、改行コードは LF のみとします。
108     Windows環境など、プラットフォームが EUC環境でない場合は、適宜
109     一括変換して扱うなどして対応することとします。
110 ryuz 1.1
111    
112 ryuz 1.2 2.3.2. CVSのコミットログ
113 ryuz 1.1
114 ryuz 1.2 CVSのコミットログなどのテキスト入力は可能な限り、英文とします。
115     この場合、英語の苦手な方も居られると思いますので、どうしても
116     うまく掛けない場合はローマ字表記なども許可とします。
117     ただし、英語の得意な方などが、ローマ字を翻訳したり、文意の
118     誤りなど気がついた場合には、コミット実行者と連絡を取り、ログを
119     書き換えるなどの活動は制限しません（むしろ推奨いたします）。
120 ryuz 1.1
121    
122    
123 ryuz 1.2 2.4. CVS更新について
124 ryuz 1.1
125 ryuz 1.2 3.1 総則
126 ryuz 1.1
127 ryuz 1.2 原則として開発メンバーは HOS に有用と考えられる変更であれば
128     他のメンバーの同意を必要とせずにトランク（開発レーン）に対して
129     いつでも修正や機能追加を行う権限をもつものとします。
130     ただし、修正を行った場合はなるべく迅速に Developersフォーラムに
131     修正内容を報告してください。
132    
133    
134     3.2 修正作業手順
135 ryuz 1.1
136     作業範囲及び影響波及範囲が狭い場合(１つのAPIに収まる程度など）は、
137 ryuz 1.2 特に予告無く行って構わないものとします。ただし、少なくともコミット後の
138     事後報告は行うように心がけましょう。
139 ryuz 1.3 影響範囲が大きいと考えられる場合は、作業開始時に Developers フォーラム
140 ryuz 1.1 に報告を入れてから着手してください。
141 ryuz 1.2 問題があればコミットまでに他のメンバーから問い合わせが発生することが
142     期待できます。
143     また、同バグ対応を複数人が作業してしまい、無駄な二重開発を回避する
144     ことにもなります。
145 ryuz 1.1
146    
147     3.3.1 新規部分の開発
148    
149     新規機能の開発に着手する場合は、事前に Developers フォーラムなどで
150     他のメンバーに着手を宣言しましょう。
151     完成後は、ローカルの環境でテストし、問題なければCVSにコミットを掛け
152     、フォーラムなどで完了を宣言しましょう。
153    
154    
155     3.3.3 バグ修正
156    
157     パッチやバグ報告がトラッキングにあがった場合、メンバーの誰であれ
158 ryuz 1.2 それに対応する権利を持ちます（もちろん義務はありません）。
159     対処頂く場合は、トラッキング情報の担当に自分の名前を設定し、
160     「解決」欄を accepted に変更して、受け付けた旨を宣言してください。
161 ryuz 1.1 これは、同一のバグに同時に複数人が対応してしまい時間をロスする
162     ことを防ぐためです。
163     対応にあたり、決めきれない部分がある場合は Developers フォーラム
164 ryuz 1.2 にて対応策を議論しましょう。
165 ryuz 1.1 修正が終わりましたら、トラッキング情報の「解決」欄を対応結果に
166     応じて変更してください。
167     また、必要と感じた場合は、対応終了を Developers フォーラムにも
168     報告いただければ助かります。
169    
170 ryuz 1.2 メンバーがバグを発見した場合もまず、トラッキングのバグ報告に報告を
171     上げる事とします。その場合そのまま自分を担当者としても構いませんし、
172     他のメンバーが名乗り出るのを待っていても構いません。
173    
174 ryuz 1.1
175     3.3.4 コミットにより問題が生じたら
176    
177     誰かが修正を加えてコミットしたことにより問題が生じたらどうしましょう。
178     これは十分考えられます。例えば SH2 の環境でテストして問題ないと
179     判断して、コミットしたところ、H8環境で問題が出る可能性などありえる
180     からです。
181     しかし焦る必要はありません。CVSは問題が生じる前のソースをいつでも
182     取り出せます。
183 ryuz 1.2 気づいた人は、まず簡単に修正できるかどうか（ご自分の時間的余裕など
184     も含めて）判断を行ってください。
185 ryuz 1.1 容易に修正可能であれば、修正後、CVSに修正内容を反映させてフォーラムに
186     報告してください。
187 ryuz 1.2 もし、修正が容易でなければ、その旨をトラッキングのバグ報告に
188     上げて下さい。
189    
190     場合によっては修正を取り消して前のバージョンに戻すのか、そのまま
191     さらに修正して問題を解決するのか、判断が必要となる場合があります。
192 ryuz 1.1 個人で判断しかねる場合は、必要に応じて議論を行いましょう。
193    
194     何れにしろ、問題が解決するまでは、他の人は正常に動作していた
195     バージョンを取り出して現在の作業を続行させることが可能です。
196    
197    
198    
199     ------------------------------------------------------------------------------
200 ryuz 1.2 Copyright (C) 2002 by Project HOS
201 ryuz 1.1 ------------------------------------------------------------------------------
Back to OSDN">Back to OSDN
 ViewVC Help
Powered by ViewVC 1.1.26  
About OSDN
Find Software
Develop Software
Help