私は doxygen を使用して、次のような c++ 列挙型を文書化しています。
/** Members */
enum {
MEMBER_ONE, /*!< This is member one */
MEMBER_TWO /*!< This is member two */
} members;
ドキュメントは良さそうに見えますが、問題は、コードにドキュメントへのハイパーリンクがあることです (次のようなファイル ドキュメントのセクションについて話しています。
ファイル ドキュメント
file1.h
enum { MEMBER_ONE, MEMBER_TWO };
列挙型ソース コードのすべてのメンバーに改行がありません。doxygenに改行を尊重させたり挿入させたりする方法はありますか? コメント
の中に入れることは、ドキュメント自体に対してのみ機能します