“如何制作Doxygen复印件”*/&引用;没有经过处理

“如何制作Doxygen复印件”*/&引用;没有经过处理,doxygen,Doxygen,我有个问题 我在Doxygen文档中有一个mainpage,其中,结束注释分隔符“*/”位于注释中,这就是Doxygen停止生成页面的地方,因为它认为这就是页面的结束。如何使Doxygen在不进行处理的情况下复制它 它看起来像这样: /** @mainpage The end comment delimiter in Doxygen is */ ... bla bla bla... **/ 在这里我要提到的是,我已经尝试过@code和@verbatim,但它们正在生成代码块,这是我不想要的 提

我有个问题

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

它看起来像这样:

/**
@mainpage
The end comment delimiter in Doxygen is */
... bla bla bla...
**/
在这里我要提到的是,我已经尝试过
@code
@verbatim
,但它们正在生成代码块,这是我不想要的


提前谢谢

以下似乎有效(至少对C#而言):

//
继续前面的注释,但由于它不是以
/**
开头,因此
*/
不作为该注释的结尾。
\n
将把
。。。bla bla bla…
在新行上

编辑 这适用于程序内构造(如类或枚举)的doxygen注释,但不适用于
@mainpage
部分

第二次编辑 仅使用单行注释,并设置
MULTILINE\u CPP\u IS\u BRIEF
标志现在似乎可以与
mainpage
部分一起使用

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

这显然意味着您需要使用
//
注释样式,至少在主页部分是这样,但这似乎是唯一的选项(除非
*/
是一个可行的选项:p)

这也是一个小技巧,但对于HTML和LaTeX输出,您可以使用它

/**
@mainpage
The end comment delimiter in Doxygen is \endcomment
... bla bla bla...
**/
以及配置文件中的以下别名定义:

ALIASES = endcomment="\htmlonly*/\endhtmlonly\latexonly$\ast$/\endlatexonly"

它不是与我的C++东西一起工作的:(当我做了<代码> \f$*/\f$< /代码>时,如果你安装了胶乳,它就工作了,但是Doxygen所做的是,它使用胶乳生成一个方程式,从它中制作出一个位图图像,并将它嵌入到HTML页面(或者PDF,取决于你想要的输出)。只要你不想生成RTF。(我不知道),它可以工作。但我仍然很好奇如何仅用纯文本来完成。啊,抱歉-我用我已经有过的课堂评论尝试过了,这还可以,但在
@mainpage
上它似乎不能以同样的方式工作。我已经用另一个建议更新了我的答案。谢谢你的编辑!如果我有问题,这将是合适的d一个非常小的主页。但是由于主页有数百行,这可能会变得非常乏味,除非我写一个脚本将
//
放在每行的前面。我很惊讶Doxygen没有任何特殊的命令,只打印内容而不处理它。老实说,我也很惊讶-一个内联的逐字逗号nd似乎是一个明智的选择。正则表达式应该能够在每一行的开头添加一个
//
(不过,正则表达式不是很热门,所以我不太确定如何做-关于锚的一些事情…)太棒了!还有PDF和RTF的功能吗?PDF是从latex生成的,因此可以与上面的解决方案一起使用。对于RTF,doxygen中的\rtfonly..\endrtfonly仍然存在一个问题,我需要解决这个问题(目标版本1.8.1)。然后您可以将\rtfonly\2a/\endrtfonly添加到别名定义中,使其也可以用于RTF。
ALIASES = endcomment="\htmlonly&#42;/\endhtmlonly\latexonly$\ast$/\endlatexonly"