Doxygen 中的重复输出

Question

我正在使用 Doxygen 生成开发人员文档。它正确解析所有文件，但输出在成员函数列表和类图中生成重复条目。

有什么想法吗？

Answer 1

我遇到了这个确切的问题，发现我不小心在INPUT 行中指定了一个构建文件夹，因为RECURSIVE 处于打开状态，例如，

示例文件结构：

./
  MyLibrarySources/
  Libs/
  build/

Doxyfile：

INPUT     = ./ MyLibrarySources/ ...
RECURSIVE = YES

这导致 Doxygen 解析来自两个不同位置的标头：一次来自 MyLibrarySources/，一次来自 build/，产生重复的成员和其他奇怪的结果。

简单的解决方案是将构建目录添加到EXCLUDE 行，例如：

EXCLUDE   = "build"

这使得 Doxygen 不会在两个不同的位置解析相同的头文件。是的，源代码构建目录通常是一个坏主意，将它们放在其他地方。就我而言，默认情况下，不是从我的 IDE 发出的命令行构建会去那里。

编辑说明：由于INPUT 行中的双重规范，我错误地认为源文件被解析了两次。不是这种情况。 Doxygen 对此很聪明，不会两次解析同一个物理文件?。