gpt4 book ai didi

c++ - Doxygen:使用 C++ 和 VHDL 的项目的无缝文档

转载 作者:可可西里 更新时间:2023-11-01 17:58:59 26 4
gpt4 key购买 nike

我正在建立一个关于某种库的文档,它由一个 C/C++ 部分和一个 VHDL 部分组成,加上一些指导性的纯 doxygen 页面。他们必须被放入一个独立的组中。到目前为止一切正常,漂亮而蓬松......

但是,如果我想使用 OPTIMIZE_OUTPUT_VHDL = YES 优化 vhdl 子目录中的输出并使用 OPTIMIZE_OUTPUT_C = YES 优化 c 子目录中的输出怎么办同时?

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

你会怎么做?

最佳答案

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

  1. 为 C 代码和 VHDL 代码创建一个不同的目录(+ 各自的 doxygen 注释文件 - 因为我们不想到处都使用 doxygen 标签来垃圾邮件代码)。
  2. 为每个目录运行 Doxygen(每个目录都有自己的优化标签 - OPTIMIZE_OUTPUT_VHDLOPTIMIZE_OUTPUT_C)
  3. 合并(手动!!!- 尽管您可以为其创建脚本)这两个目录的输出,以便主页引用这两个目录。

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

关于c++ - Doxygen:使用 C++ 和 VHDL 的项目的无缝文档,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/5102770/

26 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com