如何使用doxygen对类中的多个方法进行分组？

Question

Doxygen是一个非常好的c ++代码文档工具。我想知道它是否具有在类中分组许多相关方法并为其提供含义注释的功能。例如：

class A : public B
{
public:
    //// Begin group: Methods to implement class B's interface.

    //! ...
    void b1();

    //! ...
    void b1();

    //// End group

};

组信息显示在doxygen生成的类文档中。感谢。

Answer 1

您可以使用@name标记来达到类似的功能。看看这个例子，这很容易。

/**
 * @name Appends data to the container.
 *
 * @param tag Name of the data entry
 * @param value Data value
 */
//@{
/**
 * @brief Documentation for this overload
 */
void append(const std::string & tag, bool value);

/**
 * @brief Documentation for this overload
 */
void append(const std::string & tag, int8_t value);

void append(const std::string & tag, int16_t value);
void append(const std::string & tag, int32_t value);
//@}

它产生以下输出：