doxygen - 如何在 Doxygen 中为 \xrefitem 指定描述？

Question

我正在使用该\xrefitem命令创建一堆自动交叉引用的用户定义部分。例如，我使用的别名之一如下所示：

hack=\xrefitem hack \"Hack\" \"Wall of Shame\""

这一切都很好。文档完全按照我的意愿生成，“相关页面”页面上出现了“耻辱墙”的链接：

    

但我不知道如何在此链接的右侧添加说明。那里的那个空的描述单元只是乞求被填满。我怎样才能让它快乐？

虽然文档没有表明这是有效的语法，但我尝试在别名末尾附加描述，如下所示：

hack=\xrefitem hack \"Hack\" \"Wall of Shame\" \"Some sample descriptive text\""

但它没有用；它只是破坏了其他一切。

Answer 1

你可以做

/*! @page hack 
 *  @brief Some sample descriptive text.
 *  @par
 */

请注意，@par不应该需要虚拟对象，但由于 doxygen 中的逻辑错误，目前需要它，我将在下一个版本中修复它。