MIRS ソフトウェア開発規約


1 ディスク管理について

MIRSソフトウェアに関する全てのディスクをディレクトリに保存する。 ディスク損失に備え、ディスクはバックアップディスクに保存することとする。

ファイル変更の際は、ディレクトリ中のファイルをコピ−したものを使って作業する。変更作業終了後、変更したディスクをディレクトリにコピ−する。


2 ファイル管理について

 (1)プログラムはモジュ−ル毎に分割する。

  ・拡張子で、以下のように区別する。

     モジュ−ル名.c  (C言語のソ−ス)

     モジュ−ル名.src (アセンブリ言語のソ-ス)

 (2)プログラムには、version番号をつける。

  ・書式:Ver.上位(1桁).下位(2桁)

     上位 −大規模な変更の際、1増やす

     下位 −小さな変更の際、1増やす

     *初期versionは、Ver.1.01とする。

 (3)version管理

  ・全てのversionのファイルを必要に応じ取っておく。


3 プログラム書式について

 (1)コメントの付け方

  ・コメントが次行にまたがらない場合、ソースからタブを1つ開けてから記述する。

    例:ct=0;[TAB]/*カウンタ初期値*/

  ・コメントが複数行にまたがる場合、行頭の/*で始め、行頭の*/で終わる。

   例:/*

     =====================

     = XXXXXX.C Ver.1.01 =

     = written by XXXX   =

     =====================

     */

 (2)関数名について

  ・関数名はモジュール名を元に付ける。

  ・15字以下とする。

 (3)関数記述の規定

  ・関数の型 関数名(引数の型 引数名、引数の型 引数名、・・・)

  ・{

      内部変数の宣言─────────┐

      └───────────────┘

      関数の内容───────────┐

      └───────────────┘

    }

   例:整数を加算する関数

     int add(int a,int b)

     {

     int c;

     c = a+b;

     retuan c;

     }