我正在建立一个关于某种库的文档,该库由 C/C++ 部分和 VHDL 部分以及一些仅包含 doxygen 的指导性页面组成。他们必须被放入一个独立的组中。到目前为止一切正常,漂亮又蓬松......
但是如果我想通过使用优化 vhdl-子目录中的输出怎么办OPTIMIZE_OUTPUT_VHDL = YES
并通过使用优化 c 子目录的输出OPTIMIZE_OUTPUT_C = YES
同时?
据我了解,使用doxygen 标签 http://www.doxygen.nl/manual/external.html在我的情况下并不是最佳的,因为它在每个子目录中引入了新的 doxyfile.conf 文件,并且在每个子目录中独立运行 doxygen。因此,这样做我不能再将两个部分(c+vhdl)放在同一组的不同子组中,并且两个部分之间的链接是不可能的。此外,整个模块应该是“独立的”,可以包含在更大的文档中,而无需此解决方案涉及的特殊构建结构......
你会怎么办?
我遇到了同样的问题 - 最终我们所做的是:
- 为 C 代码和 VHDL 代码创建一个不同的目录(+各自的 doxygen 注释文件 - 因为我们不想到处都用 doxygen 标签发送垃圾邮件)。
- 为每个目录运行 Doxygen(每个目录都有自己的 oprimization 标签 -
OPTIMIZE_OUTPUT_VHDL
or OPTIMIZE_OUTPUT_C
)
- 合并(手动!!!-尽管您可以为其创建脚本)这两个目录的输出,以便主页引用这两个目录。
最终我决定缩短生成文档所需的时间,我只是忽略优化标签......
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)