0

Doxygen 1.7.x を使用すると、次の問題が発生します。サブディレクトリにさまざまなファイルをドキュメント化すると、対応するModulesページで、パスの有無にかかわらず、異なるファイル名スタイルで参照されます。しかし、モジュールページに相対パス(プロジェクトルートから)が必要です。

2 つのファイルは、次のようにタグ付けされます。

/**
 * @addtogroup examples_itsolver
 * @{ 
 * @file example/itsolver/bicgstab_1.c 
 * @brief Demostrate the usage of BiCGStab 
 * @date 05/21/2012 
 * @version $Id$
 *@}
 */

/**
 * @addtogroup examples_itsolver
 * @{ 
 * @file example/itsolver/sor.c 
 * @brief Demostrate the usage of SOR
 * @date 05/21/2012 
 * @version $Id$
 *@}
 */

これにより、

file    bicgstab_1.c
        Demonsrate the usage of BiCGStab.

file    example/itsolver/sor.c
        Demonstrate the usage of the SOR Iterative Solver. 

ページでModule overviewsor.cしかし、プロジェクト全体のように、すべてのファイルを文書化したいと考えています。どうすればこれを達成できますか?構成オプションを使用FULL_PATH_NAMESしても役に立ちません。

完全な例 (生成された html 出力を含む) は、http://www-e.uni-magdeburg.de/makoehle/doxygen_error.tgzで入手できます。

4

1 に答える 1

1

問題は、あなたの例では、sor.cという2つのファイルがあることです。

example/itsolver/sor.c
lib/itsolver/sor.c

doxygenは、名前を一意にするために必要なだけパスを付加します。

exampleに使用例が含まれている場合は、これらを入力に含めない方がよいですが、代わりに@ snippet、@ include、または@exampleを使用EXAMPLE_PATHして、exampleディレクトリをポイントしてください。

于 2012-05-22T19:20:36.100 に答える