代码之家 › 专栏 › 技术社区 › Stefan

Doxygen:代码列表中的每一行都以星号(*)开头

code-formatting doxygen

Stefan · 技术社区 · 11 年前

我正在使用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文档。不过,这两种格式都会出现问题。有人知道如何解决这个问题吗? (我使用的是1.8.5的脱氧核糖核酸)

2 回复 | 直到 11 年前

doxygen 11 年前

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

我刚刚对GitHub进行了修复。如果它能解决问题,请告诉我。

Stefan 11 年前

这似乎是一个bug。 Bugzilla entry . 而且 this bug 可能是相关的。

我设法通过更改以下片段找到了一个变通方法

/// 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

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

推荐文章

Dale Barnard · 如何阻止Doxygen为C#项目生成包索引?

7 年前

Rishu Mehra · 页面未显示在Doxygen文档中

7 年前

xMutzelx yamini jhamnani · SVN关键字显示在doxygen中

7 年前

Ganesh K · JSDoc-指定强制参数语法

8 年前

much · doxygen:一个描述框中有两个makro

9 年前

holroy · 结构doxygen的所有引用列表

10 年前

Issam T. · doxygen中引用运算符的问题

11 年前

Hi-Angel · DoxyGen忽略函数

11 年前

georg · doxygen忽略封装在语句中的类

11 年前

Stefan · Doxygen:代码列表中的每一行都以星号(*)开头

11 年前