doxygen @section 标签

在 Doxygen 中，@section 标签用于将注释分成不同的章节或部分，以便更好地组织注释内容。您可以使用不同的标题来指定不同的章节，例如“概述”、“用法示例”、“参数说明”、“返回值”等。以下是一个示例：

/**
 * @brief This function does something important.
 *
 * This function is responsible for performing an important task. The function can be
 * divided into several sections:
 *
 * @section Usage Usage
 * To use this function, you need to follow these steps:
 * 1. Call the function with the appropriate input parameters.
 * 2. Wait for the function to finish.
 * 3. Retrieve the output value from the function.
 *
 * @section Parameters Parameters
 * This function takes the following input parameters:
 * - @p x: The input parameter.
 *
 * This function returns the following output parameter:
 * - @p y: The output parameter.
 *
 * @return The result of the computation.
 */

在这个例子中，我们使用 @section 标签将注释分成了三个不同的章节，即“用法示例”、“参数说明”和“返回值”。每个章节都以不同的标题开头，并详细描述了相关信息。在生成的文档中，这些章节将以粗体字和不同的颜色显示，以便读者更容易地区分它们。