0

我在使用 Doxygen 1.7.x 时遇到了以下问题：我在子目录中记录了各种文件，并且在相应的Modules页面上使用不同的文件名样式引用它们，包括路径和不带路径。但我想在模块页面上有相对路径（wrt 项目根目录）。

这两个文件的标记如下：

/**
 * @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 overview页面上。但我希望sor.c在整个项目中记录所有文件。我怎样才能做到这一点？使用FULL_PATH_NAMES配置选项没有帮助。

完整示例（包括生成的 html 输出）可在http://www-e.uni-magdeburg.de/makoehle/doxygen_error.tgz上找到

4

1 回答 1

1

问题是在您的示例中有两个名为 sor.c 的文件

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

doxygen 将根据需要添加尽可能多的路径以使名称唯一。

如果 example 包含使用示例，那么最好不要在输入中包含这些，而是​​使用 @snippet、@include 或 @example 并指向EXAMPLE_PATH您的示例目录。

于 2012-05-22T19:20:36.100 回答