在连续注释块之间保持 doxygen 中的列表缩进答案

【问题标题】：Keep list indentation in doxygen between successive comment blocks在连续注释块之间保持 doxygen 中的列表缩进
【发布时间】：2013-03-28 15:01:35
【问题描述】：

我想在我的代码中使用 Doxygen cmets 来创建项目符号列表，以补充生成文档中的函数描述。比如下面的sn -p代码：

/**
 * Function x
 */
void function (void) {
/// List:
/// - comment A
;
;
/// + comment B
;
;
/// * comment C

}

应该产生这样一个列表：

List:
- A
  - B
    - C

不幸的是，Doxygen 似乎没有保持从一个注释块到另一个相同函数的缩进级别。有解决办法吗？

谢谢

【问题讨论】：

【解决方案1】：

经过过去几个小时的研究，我得出的结论是，跨非连续 doxygen cmets 的缩进列表是不可能的。

我能够轻松获得缩进列表以在块 cmets 中工作：

/**
-# Item 1
    -# Subitem 1
    -# Subitem 2
-# Item 2
*/

切换到单行 cmets 仍然有效：

/// -# Item 1
///     -# Subitem 1
///     -# Subitem 2
/// -# Item 2

当我在单行 cmets 之间添加代码时，doxygen 停止缩进子项。

【讨论】：

【解决方案2】：

实际上可以使用 HTML 格式来做到这一点

//! <ul><li> Entering a condition:<ul>
if (xx)
{
    //! <li> something
    C=A+B;

    //! <li> something else
    D="lol";
}
//! </ul></ul>

【讨论】：