0

プロジェクトの文書化に 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でこれを達成する方法はありますか?

4

1 に答える 1