使用 Doxygen 生成单独的连续注释条目

Question

假设我正在写这样的 Doxygen 评论

/**
 * \brief Foo
 * \details FooFooBar
 * \note Note1 goes here
 * \note Note2 goes here
 */

注释 1 和注释 2 呈现为同一注释部分的两个段落。我希望他们一个接一个地进入两个分开的注释部分。我怎样才能做到这一点？使用花括号和额外的换行符没有用。

Answer 1

您可以将每个 \note 包装在 \parblock..\endparblock 中，如下所示：

/**
 * \brief Foo
 * \details FooFooBar
 * \parblock
 * \note Note1 goes here
 * \endparblock
 * \parblock
 * \note Note2 goes here
 * \endparblock
 */

使用 Doxygen 生成单独的连续注释条目

Generating separate consecutive Note entries with Doxygen

doxygen