如何从一个生成器函数中使用 @copydoc
我有一个函数 testFixture,其中包含大量Doxygen注释。这个函数在一个测试函数 testA 中被调用,并且该测试函数会产生 testFixture。
应用 @copydoc testFixture 或其完全限定版本似乎不起作用。不过,如果把它应用到任何不会产生它的其他函数上,拷贝就能正常完成。
查看XML的时候,似乎Doxygen为 testFixture(来自yield语句)同时创建了函数条目和变量条目,但总是解析到空的变量条目,而不是文档化的函数条目。
有解决办法吗?
解决方案
你可以通过提供完整的函数签名(包括括号),而不是仅写函数名,来强制 @copydoc忽略变量条目。这样可以明确告诉Doxygen你指向的是一个函数
不是这个:
## @copydoc testFixture
把它改成这个:
## @copydoc testFixture()
站内所有文章版权归属LeftHeroAI导航站,无授权禁止任何主体转载、抄袭、复制内容,亦不得私自架设镜像站点。一经侵权,本站将通过法律途径追责。