我正在开发一个专有工具,它使用类似 C++ 的语言来定义各种方法。该工具提供了自己的编译器来将这些方法编译成 .so 文件。它不遵循 C++ 的“声明-定义”语法,但在其他方面非常相似。示例代码如下所示:
method _foo::bar(var message) {
// do something with 'message' here
}
我尝试使用 doxygen 记录此方法,如下所示:
/**
* @brief this method does something with @a message.
*/
method _foo::bar(var message) {
// do something with 'message' here
}
但这给了我一个警告:
warning: documented function `method _foo::bar' was not declared or defined.
我尝试将@fn method _foo::bar()
、、@fn _foo::bar
和添加@fn bar
到注释块(一个接一个),但它们都没有导致将@brief
消息添加到文档中。
我已经在 Stack Overflow 上进行了搜索,这篇Doxygen 评论与 C++ 标头中未声明的函数最接近我的问题,但它并不能完全解决我的问题。
有没有办法配置 doxygen 来为函数生成文档,而不管它是否未声明?