□細かい話
関数の前に書くような、割合大きなコメントは、各種の流儀があるようです。コメントのスタイルも、千差万別といえます。私の場合は、次のようなスタイルですが、これは結構よく見かけるものです。
/* このように、1行目から平気で文章を書き始め、
* 必ず左側にアスタリスク (*) が現われるようにします。
*/
アスタリスクを書いておけば、検索した時に、表示された行がコメントなのかどうか、一目で分かります。
プログラムの先頭に書くコメントには、自分の名前や日付を入れておいた方がいいでしょう。PDS にするつもりがないなら、Copyright の表示も書いておいた方がいいと思います。
“
| — | Cプログラミングの秘訣 |