将库的文档与重叠的后缀结合起来

Question

我想合并两个库的文档：Bar 和 MyBar。但是，这会导致重叠路径出现奇怪的问题。

考虑这个项目：

Doxyfile
Bar/config.h
MyBar/config.h

Doxyfile

INPUT = Bar MyBar

和Bar/config.h:

/**
Lorem ipsum

\file Bar/config.h
*/

/**
Some bar lib.
*/
namespace Bar {

} // namespace Bar

和MyBar/config.h:

/**
Lorem ipsum

\file MyBar/config.h
*/

#include <Bar/config.h>

/**
Some other library
*/
namespace MyBar {

} // namespace MyBar

使用 doxygen 1.9.1 构建会给出以下警告：

Bar/config.h:4: warning: the name 'Bar/config.h' supplied as the argument in the \file statement matches the following input files:
   /myprojectdir/Bar/config.h
   /myprojectdir/MyBar/config.h
Please use a more specific name by including a (larger) part of the path!

我真的不知道如何解决这个问题：没有更大的路径要指定（相对意义上）。

Answer 1

\file 中目录名称的使用是潜在的问题来源。 当文件的文档块位于文件本身时，有两种解决方案：

1. 使用不带文件名的\file 命令
2. 在没有目录的情况下使用\file 命令

我个人会选择第一个解决方案，因为在重命名文件的情况下，这也不必使用 \file 命令完成。