如何使用 doxygen 生成 Unity 的内部文档？

Question

Unity 的 Hacking 文件说：

通过安装并运行 doxygen 可以为 Unity 构建内部文档make doxygen。

我不熟悉 doxygen，需要在具体命令方面获得一些帮助。

我使用以下命令下载了 Unity 源代码：bzr branch lp:unity并运行doxygen Doxyfile.in。

它生成了api-doc/html许多文件，但index.html加载了一个空框架。

我读了手册文件和在线手册/常见问题解答但我仍然不确定我需要做什么。

Answer 1

我让它工作了。我假设该Doxyfile.in文件适用于任何系统，而我所要做的就是运行doxygen Doxyfile.in。

事实上，我发现 doxygen 需要作为 cmake 目标运行，但我还不想完成整个构建。

要将 doxygen 作为独立进程运行，我需要编辑包含源文件目录的实际路径Input的部分Doxyfile.in，注释掉用于 make 文件的现有路径变量。

此后，doxygen Doxyfile.in工作正常。