doxygen - Doxygen：代码清单中的每一行都以星号 (*) 开头

Question

我正在使用 doxygen 为 C++ 库创建 HTML 文档。

现在我有一个问题，即使用\code ... \endcode生成列表创建的代码列表，其中每行都以星号开头。

例子：

Have a look at the following code sample:
\code
int a = 5;
int b = func(a);
\endcode

输出：

Have a look at the following code sample:
* int a = 5;
* int b = func(a);

我无法解释这种行为——尤其是因为我使用///而不是/**将行标记为 doxygen 文档。不过，这两种格式都会出现问题。有谁知道如何解决这个问题？（我使用的是 doxygen 1.8.5）

score 3 · Accepted Answer

这在 1.8.5 中确实是一个不幸的回归。

我刚刚向 GitHub 推送了一个修复程序。请让我知道它是否解决了问题。

score 0 · Accepted Answer

看来这是一个错误。Bugzilla 条目。这个错误也可能是相关的。

我设法通过更改以下代码段来解决问题

/// Have a look at the following code sample:
/// \code
/// int a = 5;
/// int b = func(a);
/// \endcode

到以下（注意只有两个斜杠）：

/// Have a look at the following code sample:
// \code   
// int a = 5;
// int b = func(a);
/// \endcode

我对此不满意，因为它需要重新布局所有评论并且格式感觉非常不自然。

2 回答 2