doxygen http://www.doxygen.org/ というソースコードからドキュメント(HTML/RTF/LaTeX/UNIX man)を自動生成するソフトを使ってみました。
クラス階層が画像で表示されたりとかなり高度なことができるソフトです。ソースコード中にあるコメントから解説を書いてくれるのですが、明示的に指定したQt及びJavaDoc形式コメントのみを拾い出すので現時点では全くコメントは表示されません。

そこで、今後コメントを入れるときは関数や引数の解説などドキュメントに含められそうなものはこの形式に従うようにするというのはどうでしょうか。

基本的なルールはコメントマークの直後に!を入れるだけで、/*! とか //! で始めます。

ただ、こういうことを書くとじぇぷろさんが張り切ってあちこち直し始めてしまい差分のほとんどがコメント行になってしまうという状況は勘弁してほしいと思います。あくまで直したときについでに入れるということで。