【问题标题】:Doxygen and Assembly LanguageDoxygen 和汇编语言
【发布时间】:2026-01-02 02:10:01
【问题描述】:

我想使用 Doxygen 来记录混合了 C 和 x86 汇编语言的遗留代码。汇编语言不是内联的,而是在单独的仅汇编文件中。如何记录汇编语言部分?

【问题讨论】:

    标签: documentation assembly doxygen


    【解决方案1】:

    Doxygen FAQ 的问题 12 最终将我引向了一个看起来很有希望的 Perl filter。它将汇编代码转换为 Doxygen 可以解析的类似 C 的代码。谢谢!

    原来的link 似乎已经死了。然而,早在 2008 年,我就下载了 asm4doxy.pl 的副本并将其隐藏起来。如果有人仍然感兴趣,我已经把它放在Pastebin 上。我记得,我试过了,但当时它并没有真正对我有用,而是 YMMV。

    【讨论】:

    【解决方案2】:

    请参阅Doxygen FAQ 的问题 12。您是在处理纯汇编文件还是 C 源代码中的内联汇编?假设是前者,您将不得不编写一个输入过滤器以将汇编代码转换为类似 C 的代码(更容易),或者编写一个新的解析器(更难)。

    【讨论】:

    • -1 否决票 这篇文章很老了。我想知道,是否有人已经找到了一个很好的优雅的解决方案来将汇编代码包含到 Doxygen 的文档中?当前状态:有一个可用的 Doxygen 过滤器将提供的汇编代码转换为类似 C 的结构化代码。不幸的是,过滤器的链接 (bogdro.ciki.me/inne/asm4doxy.txt) 已关闭。感谢您的帮助
    • 汇编助手 asm4doxy.pl,包括 Ida-Pro 格式现在在 github 上github.com/rfoos/doxygen