将包含文件/目录列表的文件传递给 Doxygen INPUT 标签

Question

我想弄清楚是否可以将包含文件/目录列表的文件传递给 Doxygen INPUT 标记。 如果上面的句子没有清楚地描述我的意图，请考虑一个示例，我想包含这些文件和目录以供 Doxygen 扫描并生成一些文档： ./file_1.c ./file_1.h ./file_2.c ./dir_1 ./dir_2/file_20.c ./dir_3/file_31.c ...等

如果我只想包含那些项目，我可以简单地将其附加到 INPUT 标记，并使其看起来像这样：

INPUT = ./file_1.c \
        ./file_1.h \
        ./file_2.c \
        ./dir_1    \
        ./dir_2/file_20.c \
        ./dir_3/file_31.c

但是，如果列表增长，并且文件不一定限于某个目录，最好将该列表放在一个单独的文件中，我们将其命名为 doxyInput.lst，并将其“传递”给 Doxygen。

我试过了。我将上面的列表放在 doxyInput.lst 中，然后将我的 Doxy 配置文件中的 INPUT 标记设置为：

INPUT = doxyInput.lst

但这不起作用。

Doxygen 支持我在这里尝试做的事情吗？

我尝试在 Internet 上查找它，但我想我不知道正确的搜索词，所以我没有找到我要查找的内容。非常感谢！

Answer 1

无法将带有文件名的列表直接添加到例如INPUT 但也有一些可能性，例如：

• 您不必单独列出所有文件，但您也可以使用INPUT 中的目录并使用FILE_PATTERNS 仅选择相关的文件扩展名。使用RECURSIVE 进入子目录并使用EXCLUDE_PATTERNS 排除文件（模式）。
• 将所有文件名放在一个单独的文件中（不要忘记在 结束！）并在 doxygen 配置文件（Doxyfile）中使用@INCLUDE。