Doxygen:使用C++和VHDL进行项目的无缝文档

Question

我正在建立一个关于某种库的文档,它包含一个C/C++部分和一个VHDL部分,以及一些有指导性的doxygen页面.他们必须被置于一个独立的群体中.到目前为止,一切都很有效,漂亮而蓬松......

但是,如果我想通过同时使用OPTIMIZE_OUTPUT_VHDL = YES和优化c子目录的输出来优化vhdl子目录中的输出OPTIMIZE_OUTPUT_C = YES呢？

据我所知,在我的情况下使用doxygen-tags并不是最佳的,因为它在每个子目录中引入了新的doxyfile.conf文件,并在每个子目录中独立运行doxygen.所以,这样做我不能将两个部分(c + vhdl)放在同一组的不同子组中,并且两个部分之间的链接是不可能的.此外,整个模块应该是"自包含的",可以包含在更大的文档中,而不需要在此解决方案中涉及特殊的构建结构......

你会怎么做？

Answer 1

我遇到了同样的问题 - 最终我们所做的是：

1. 为 C 代码和 VHDL 代码创建一个不同的目录（+各自的 doxygen 注释文件 - 因为我们不想到处都用 doxygen 标签发送垃圾邮件）。
2. 为每个目录运行 Doxygen（每个目录都有自己的 oprimization 标签 -OPTIMIZE_OUTPUT_VHDL 或OPTIMIZE_OUTPUT_C）
3. 合并（手动！！！-尽管您可以为其创建脚本）这两个目录的输出，以便主页引用这两个目录。

最终我决定缩短生成文档所需的时间，我只是忽略优化标签......