ついでに言っとくと、>>342 みたいに
細切れでコメントつけるのはあんまり好きじゃない。
if (is_debug() && // デバッグモードをチェック
is_error_abort() ) { // エラーで abortするかチェック
// デバッグ時エラーならアボートする
... // 必要な処理をする
} else {
// デバッグモードでないか、エラーでも abort しない場合
nr_error++; // エラーカウンタを更新
... // 必要な処理をする
}
みたいに、C言語の日本語直訳を書くだけになりやすい。
それなら
/*****************************
* この関数は○○の時は△△します。
* 詳細は http://＜社内サイトの仕様書置き場＞
* の □□ のフローを参照してください。
* データフォーマットは grep -r Hoge_data ./sub1/include で探してしてください。
*****************************/
とでも書いてあったほうがわかるよ。
