doxygen - 如何在不处理的情况下制作 Doxygen 副本“*/”

Question

我有个问题。

我有一个mainpageDoxygen 文档，在其中，结束注释分隔符“*/”在注释中，这就是 Doxygen 停止生成页面的地方，因为它认为这是它的结尾。如何在不处理的情况下让 Doxygen 复制它？

它看起来像这样：

/**
@mainpage
The end comment delimiter in Doxygen is */
... bla bla bla...
**/

在这里我应该提到我已经尝试过@codeand @verbatim，但是那些正在制作代码块，这是我不希望的。

提前致谢！

score 3 · Accepted Answer

这也是一个 hack，但对于 HTML 和 LaTeX 输出，您可以使用

/**
@mainpage
The end comment delimiter in Doxygen is \endcomment
... bla bla bla...
**/

连同配置文件中的以下别名定义：

ALIASES = endcomment="\htmlonly&#42;/\endhtmlonly\latexonly$\ast$/\endlatexonly"

score 2 · Accepted Answer

以下似乎有效（至少对于 C#）：

/**
@mainpage
The end comment delimiter in Doxygen is
**/
/// */ \n
/**
... bla bla bla...
**/

///继续上一条评论，但由于它不是以 a 开头的，/**因此*/不被视为该评论的结尾。\n就是把它放在... bla bla bla...一个新的线上。

编辑

这适用于程序中构造的 doxygen 注释（如类或枚举），但不适用于该@mainpage部分。

仅使用单行注释并设置MULTILINE_CPP_IS_BRIEF标志现在似乎适用于该mainpage部分

/// @mainpage
/// The end comment delimiter in Doxygen is */
/// ... bla bla bla...

这显然意味着您需要使用///评论样式，至少对于主页部分，但这似乎是唯一的选择（除非* /是一个可行的选择：P）