如何在Doxygen代码示例中插入多行注释

Question

我正在尝试在Doxygen文档中包含一个包含多行注释的代码示例。问题是C ++预处理器将*/解释为我的Doxygen注释的结尾，因此文件的语法被破坏。

例如：

/*! \brief My Doxygen comment.
 *
 * \code
 * myFunction() /* Some multi-line comment */
 * \endcode
 */

我已经尝试过适用于JavaDoc注释的建议：使用HTML实体对斜杠进行编码，如下所示：

* \code
* myFunction() /* Some multi-line comment */
* \endcode

但这不起作用（我想因为Doxygen不会替换代码部分中的HTML实体）。

所以问题是：是否可以在代码示例中包含多行注释以及如何完成？

Answer 1

使用不同的评论样式。

使用：

而不是你拥有的

/// \brief My Doxygen comment.
/// 
/// \code
/// myFunction() /* Some multi-line comment */
/// \endcode
///

///与/*!相同，并标记了doxygen部分。预处理器会将每一行视为单行注释。