プロジェクトの文書化に Doxygen を使用しています。1 つのファイルに、グループに入れたいパブリック関数がたくさんあります。私は次のようにこれを行います:
/**
@file myFile.c
@brief This is a file. It has stuff.
*/
/**
@defgroup my_group Group with myFile.c stuff
@{
*/
//CODE & STUFF WITH DOCUMENTATION
/**
@}
*/
問題は、LaTeX 出力にここにあるすべてのドキュメントが 2 回含まれていることです。「モジュール ドキュメント」セクションで 1 回、「ファイル ドキュメント」セクションでもう一度。これは、私の最終的な PDF ファイル (LaTeX から生成されたもの) でおそらく 25 ページの純粋に重複したものに相当します。
理想的な修正は、myFile.c のファイル ドキュメンテーションに「@ref my_group を参照」などと記載することです。Doxygenでこれを達成する方法はありますか?