如果我有以下内容:
/** * @brief (x,y,z) points for block */ int x, y, z;
它只会生成x的文档,是否可以在doxygen中使用一条注释对所有x,y和z进行注释?
编辑按照envu的建议我现在有以下内容(基于https://www.stack.nl/~dimitri/doxygen/grouping.html#memgroup )
//@{ /** some documentation here */ int x, y, z; //@}
要么
//@{ /** * @brief some documentation here */ int x, y, z; //@}
然而,这两个仍然只记录x。 尝试使用不同的表单我还没有得到相同的文档字符串来跨越多个变量
我会使用成员组 语法和输出与你想要实现的有点不同,但我认为不应该受到伤害。
我已经在这个问题上敲了一会儿。 事实certificate,您必须在配置中设置DISTRIBUTE_GROUP_DOC = YES
。
我意识到这是一个老问题,但我遇到了类似的问题,并找到了一个解决方案,但并不能完全解决问题,但在某些情况下可能是一个可接受的替代品。
通过在成员组块上方添加注释并在其前面添加name
装饰器,您将获得一个描述,该描述显示在Doxygen页面的属性列表中成员组中的所有变量之上。 我相信这是一个简短的描述,但如果你愿意,你可以在这里添加任意长的描述。
这不会在成员组中的每个变量的详细信息字段中添加相同的注释(详细信息字段将为空,或者如果您在成员组块中放置注释,它仍将仅适用于第一个变量),但它确实具有将相关的变量组记录在一起的效果,这看起来像问题的原始意图。
例:
/*! name This will be the description for the following group of variables It can be arbitrarily long, but the first line will show up in bold, and any subsequent lines will show up like a description under it */ //@{ int relatedVariable1; int relatedVariable2; char* relatedVariable3; //@}
我在“专家”选项卡中设置了“DISTRIBUTE_GROUP_DOC”选项。 他们所有成员都收到了同样的评论。
//@{ /** same comment for all members */ char aaa; char bbb; int ccc; //@}
以上就是c/c++开发分享doxygen一次注释多个变量相关内容,想了解更多C/C++开发(异常处理)及C/C++游戏开发关注计算机技术网(www.ctvol.com)!)。
本文来自网络收集,不代表计算机技术网立场,如涉及侵权请联系管理员删除。
ctvol管理联系方式QQ:251552304
本文章地址:https://www.ctvol.com/c-cdevelopment/562724.html