Doxygen:使用 C++ 进行项目的无缝文档和VHDL
我正在建立一个关于某种库的文档,该库由 C/C++ 部分和 VHDL 部分以及一些仅包含 doxygen 的指导性页面组成。他们必须被放入一个独立的组中。到目前为止,一切正常,漂亮又蓬松...
但是,如果我想使用 OPTIMIZE_OUTPUT_VHDL = YES 优化 vhdl 子目录中的输出并使用 OPTIMIZE_OUTPUT_VHDL = YES 优化 c 子目录的输出,该怎么办>同时OPTIMIZE_OUTPUT_C = YES?
据我了解,使用 doxygen-tags 在我的情况下并不是最佳选择,因为它在每个子目录中引入了新的 doxyfile.conf 文件,并且在每个子目录中独立运行 doxygen。因此,这样做我不能再将两个部分(c+vhdl)放在同一组的不同子组中,并且两个部分之间的链接是不可能的。另外,整个模块应该是“独立的”,可以包含在更大的文档中,而无需此解决方案中涉及的特殊构建结构......
您会做什么?
I'm setting up a documentation about some sort of Library which consists of a C/C++ part and a VHDL part, plus some instructive doxygen-only pages. They have to be put into one self-contained group. Everything works so far, nice and fluffy...
But what if I want to optimize the output in the vhdl-subdirectory by using OPTIMIZE_OUTPUT_VHDL = YES
and optimize the output of the c-subdirectory by using OPTIMIZE_OUTPUT_C = YES
at the same time?
As far as I understand, using doxygen-tags is not optimal in my case, since it introduces new doxyfile.conf-files in each subdirectory, with independent runs of doxygen in each subdirectory. So, doing this I can't put both parts (c+vhdl) in different subgroups of the same group anymore, and links between the two parts are not possible. Also, the whole module should be "selfcontained", to be includable into bigger documentations, without the special build-structure involved in this solution...
What would you do?
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
我遇到了同样的问题 - 最终我们所做的是:
OPTIMIZE_OUTPUT_VHDL
或OPTIMIZE_OUTPUT_C
)最终我决定缩短生成文档所需的时间,我只是忽略优化标签......
I had the same problem - eventually what we did is:
OPTIMIZE_OUTPUT_VHDL
orOPTIMIZE_OUTPUT_C
)Eventually I decided to shorten the time it takes to generate the documentation, and I just ignore the optimization tags...