ついでに言っとくと、>>342 みたいに
細切れでコメントつけるのはあんまり好きじゃない。

if (is_debug() && // デバッグモードをチェック
　　is_error_abort() ) { // エラーで abortするかチェック
　　// デバッグ時エラーならアボートする
　　... // 必要な処理をする
} else {
　　// デバッグモードでないか、エラーでも abort しない場合
　　nr_error++; // エラーカウンタを更新
　　... // 必要な処理をする
}

みたいに、C言語の日本語直訳を書くだけになりやすい。


それなら
/*****************************
* この関数は○○の時は△△します。
* 詳細は http://＜社内サイトの仕様書置き場＞
* の □□ のフローを参照してください。
* データフォーマットは grep -r Hoge_data ./sub1/include で探してしてください。
*****************************/
とでも書いてあったほうがわかるよ。