doxygen

は、まだwindows環境にしかインストールしていないのですが、慣れておくようにと思い、http://members.at.infoseek.co.jp/sakura_editor/comment-rule.htmlや2005-08-04やhttp://www.sat.t.u-tokyo.ac.jp/~tetsuya/homeNew/research/Tips/doxygen.htm
を参考にコメントを入れつつあります。
とりあえず

/*!

が開始

*/

で終了

@file

が自身のファイル名

@brief

で簡潔なコメント

@date

で日付のログ（？　ログ管理はバージョン管理ソフトに任せたほうが良い？）

@author

で作者,という部分は書くようにしました。
いずれsubvertion（今度こそ！）で管理できるようにしたいと思います。