2

我正在开发一个一半 Lua 一半 C++ 的代码库。我们使用 Doxygen 来记录我们的 C++ 代码。

现在,我们也想在 Lua 部分使用 Doxygen。但是 Doxygen 缺乏对 Lua 的支持。

一个项目为 Doxygen 添加了 Lua 支持。它是用 Perl 编写的,我理解它的作用。它实现了一个过滤器,将 Lua 源文件转换为 Doxygen 可以解析的东西。但是,Doxygen 似乎无法识别所有功能等。

所以我的问题真的是:Doxygen 对过滤器的期望格式是什么?

4

1 回答 1

4

严格的答案是您的过滤器应该以 doxygen 支持的语言生成语法上有效的输出(您可以使用EXTENSION_MAPPING将您的语言的文件扩展名映射到支持的语言)。

由于 doxygen 的解析器相当松散(它是一个词法扫描器,而不是真正的解析器),如果您不 100% 遵循该语言的语法规则,它可能也能正常工作,但这将是一个跟踪和错误的过程来找出如果您升级到 doxygen 的未来版本,哪些偏差是允许的并且可能会中断。

于 2012-05-24T18:32:19.870 回答