是否只在选定的文件/模块上运行Doxygen？

Question

最近，我开始在一个现有的项目中编写一些doxygen文档，这个项目已经有了相当多的doxygen注释。

因为我学到了一点--我喜欢迭代进行编辑和生成文档，因为文档生成相当慢-3-5分钟。这就变得不可行了。

我删除了源码树中的大多数文件，所以doxy只找到了我正在编辑的那些文件，但这真的是一个可怕的解决方案，而且不是我想经常做的事情。

有没有一种方法(命令行arg或环境变量)-限制哪些文件/模块用于生成文档-以便可以更快地重建文档？

Answer 1

是的，您可以从命令行或通过环境变量定制Doxygen的行为。例如，如果您只想包含一个文件(include/somefile.h)，则可以执行Doxygen，如下所示：

( cat Doxyfile ; echo "INPUT=include/somefile.h" ) | doxygen -

有关从命令行自定义行为的更多详细信息，请参阅Doxygen FAQ的"Can I configure doxygen from the command line?“

或者，如果要使用环境变量，可以使用在配置文件中指定类似以下内容：

INPUT = $(FILE)

Doxygen在其配置文件上执行环境变量替换，允许您使用以下命令指定应对哪些文件执行操作：

export FILE=include/somefile.h
doxygen Doxyfile

有关在配置文件中使用环境变量的详细信息，请参阅Doxygen Configuration。