| 1 |
------------------------------------------------------------------------------ |
------------------------------------------------------------------------------ |
| 2 |
Project HOS 開発ポリシー(草案) |
Project HOS 開発ポリシー(草案) |
| 3 |
|
|
| 4 |
Copyright (C) 2002 by Project HOS |
Copyright (C) 2002-2004 by Project HOS |
| 5 |
------------------------------------------------------------------------------ |
------------------------------------------------------------------------------ |
| 6 |
|
|
| 7 |
|
|
| 42 |
各自お互いを尊重するよう心がけるものと致します。 |
各自お互いを尊重するよう心がけるものと致します。 |
| 43 |
|
|
| 44 |
|
|
| 45 |
2. 運用ルール |
3. 運用ルール |
| 46 |
|
|
| 47 |
2.1. ファイル名について |
3.1. ファイル名について |
| 48 |
|
|
| 49 |
本プロジェクトの開発の多くは、UNIX系、Windows系などクロスプラットフォーム |
本プロジェクトの開発の多くは、UNIX系、Windows系などクロスプラットフォーム |
| 50 |
をターゲットにしています。 |
をターゲットにしています。 |
| 52 |
ルールを定めます。 |
ルールを定めます。 |
| 53 |
|
|
| 54 |
|
|
| 55 |
2.2.1. 総則 |
3.2.1. 総則 |
| 56 |
|
|
| 57 |
CVSからのチェックアウトを問題なく行うための最低限のルールとして、 |
CVSからのチェックアウトを問題なく行うための最低限のルールとして、 |
| 58 |
以下のことを定めます。 |
以下のことを定めます。 |
| 64 |
・空白文字も可能な限りファイル名に含めない |
・空白文字も可能な限りファイル名に含めない |
| 65 |
|
|
| 66 |
|
|
| 67 |
2.2.2. DOS向けのファイル |
3.2.2. DOS向けのファイル |
| 68 |
|
|
| 69 |
MS-DOS用のツールに入力する可能性があるものに関してはさらに以下の |
MS-DOS用のツールに入力する可能性があるものに関してはさらに以下の |
| 70 |
るルールを定めます。 |
るルールを定めます。 |
| 73 |
・8+3形式に統一する |
・8+3形式に統一する |
| 74 |
|
|
| 75 |
|
|
| 76 |
2.2.3. Windows向けのファイル |
3.2.3. Windows向けのファイル |
| 77 |
|
|
| 78 |
総則に反しない限り、Windows文化に合わせてよいものとします。 |
総則に反しない限り、Windows文化に合わせてよいものとします。 |
| 79 |
即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を |
即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を |
| 80 |
きたさない範囲とします。 |
きたさない範囲とします。 |
| 81 |
|
|
| 82 |
|
|
| 83 |
2.2.4. UNIX系向けのファイル |
3.2.4. UNIX系向けのファイル |
| 84 |
|
|
| 85 |
総則に反しない限り、UNIX文化に合わせてよいものとする。 |
総則に反しない限り、UNIX文化に合わせてよいものとする。 |
| 86 |
即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を |
即ち、別環境でも最低限チェックアウトなどのCVS操作に支障を |
| 88 |
UNIX系の場合、実行可能属性などは適切に設定することとします。 |
UNIX系の場合、実行可能属性などは適切に設定することとします。 |
| 89 |
|
|
| 90 |
|
|
| 91 |
2.2.5. ソースファイルからの参照について |
3.2.5. ソースファイルからの参照について |
| 92 |
|
|
| 93 |
例えば C言語の #include ディレクティブなど、ソース中で |
例えば C言語の #include ディレクティブなど、ソース中で |
| 94 |
ファイル名を利用する場合、例えば、Windows環境で Sample.h |
ファイル名を利用する場合、例えば、Windows環境で Sample.h |
| 99 |
気をつけて扱うよう心がけてください。 |
気をつけて扱うよう心がけてください。 |
| 100 |
|
|
| 101 |
|
|
| 102 |
2.3. 文字コードについて |
3.3. 文字コードについて |
| 103 |
|
|
| 104 |
2.3.1. 総則 |
3.3.1. 総則 |
| 105 |
|
|
| 106 |
原則として CVS リポジトリに含めるテキストファイルは EUC |
原則として CVS リポジトリに含めるテキストファイルは EUC |
| 107 |
文字コードとし、改行コードは LF のみとします。 |
文字コードとし、改行コードは LF のみとします。 |
| 109 |
一括変換して扱うなどして対応することとします。 |
一括変換して扱うなどして対応することとします。 |
| 110 |
|
|
| 111 |
|
|
| 112 |
2.3.2. CVSのコミットログ |
3.3.2. CVSのコミットログ |
| 113 |
|
|
| 114 |
CVSのコミットログなどのテキスト入力は可能な限り、英文とします。 |
CVSのコミットログなどのテキスト入力は可能な限り、英文とします。 |
| 115 |
この場合、英語の苦手な方も居られると思いますので、どうしても |
この場合、英語の苦手な方も居られると思いますので、どうしても |
| 120 |
|
|
| 121 |
|
|
| 122 |
|
|
| 123 |
2.4. CVS更新について |
4. CVS更新について |
| 124 |
|
|
| 125 |
3.1 総則 |
4.1 総則 |
| 126 |
|
|
| 127 |
原則として開発メンバーは HOS に有用と考えられる変更であれば |
原則として開発メンバーは HOS に有用と考えられる変更であれば |
| 128 |
他のメンバーの同意を必要とせずにトランク(開発レーン)に対して |
他のメンバーの同意を必要とせずにトランク(開発レーン)に対して |
| 131 |
修正内容を報告してください。 |
修正内容を報告してください。 |
| 132 |
|
|
| 133 |
|
|
| 134 |
3.2 修正作業手順 |
4.2 修正作業手順 |
| 135 |
|
|
| 136 |
作業範囲及び影響波及範囲が狭い場合(1つのAPIに収まる程度など)は、 |
作業範囲及び影響波及範囲が狭い場合(1つのAPIに収まる程度など)は、 |
| 137 |
特に予告無く行って構わないものとします。ただし、少なくともコミット後の |
特に予告無く行って構わないものとします。ただし、少なくともコミット後の |
| 144 |
ことにもなります。 |
ことにもなります。 |
| 145 |
|
|
| 146 |
|
|
| 147 |
3.3.1 新規部分の開発 |
4.3.1 新規部分の開発 |
| 148 |
|
|
| 149 |
新規機能の開発に着手する場合は、なるべく事前に Developers フォーラム |
新規機能の開発に着手する場合は、なるべく事前に Developers フォーラム |
| 150 |
などで他のメンバーに着手を宣言しましょう(二重開発防止の為です)。 |
などで他のメンバーに着手を宣言しましょう(二重開発防止の為です)。 |
| 157 |
これは各プロジェクトのルールに従います。 |
これは各プロジェクトのルールに従います。 |
| 158 |
|
|
| 159 |
|
|
| 160 |
3.3.3 バグ修正 |
4.3.2 バグ修正 |
| 161 |
|
|
| 162 |
パッチやバグ報告がトラッキングにあがった場合、メンバーの誰であれ |
パッチやバグ報告がトラッキングにあがった場合、メンバーの誰であれ |
| 163 |
それに対応する権利を持ちます(もちろん義務はありません)。 |
それに対応する権利を持ちます(もちろん義務はありません)。 |
| 177 |
他のメンバーが名乗り出るのを待っていても構いません。 |
他のメンバーが名乗り出るのを待っていても構いません。 |
| 178 |
|
|
| 179 |
|
|
| 180 |
3.3.4 コミットにより問題が生じたら |
4.3.3 コミットにより問題が生じたら |
| 181 |
|
|
| 182 |
誰かが修正を加えてコミットしたことにより問題が生じたらどうしましょう。 |
誰かが修正を加えてコミットしたことにより問題が生じたらどうしましょう。 |
| 183 |
これは十分考えられます。例えば SH2 の環境でテストして問題ないと |
これは十分考えられます。例えば SH2 の環境でテストして問題ないと |
| 202 |
|
|
| 203 |
|
|
| 204 |
------------------------------------------------------------------------------ |
------------------------------------------------------------------------------ |
| 205 |
Copyright (C) 2002 by Project HOS |
Copyright (C) 2002-2004 by Project HOS |
| 206 |
------------------------------------------------------------------------------ |
------------------------------------------------------------------------------ |