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

【问题标题】：Generating separate consecutive Note entries with Doxygen使用 Doxygen 生成单独的连续注释条目
【发布时间】：2015-06-09 00:55:03
【问题描述】：

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

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

Note1 和 Note2 呈现为同一 Note 部分的两个段落。我希望他们一个接一个地进入两个单独的注释部分。我怎样才能做到这一点？使用花括号和额外的换行符并不能解决问题。

【问题讨论】：

标签： doxygen

【解决方案1】：

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

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

【讨论】：