如何在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中的逻辑错误，当前需要使用虚拟模型，我将在下一个版本中对其进行修复。