如何在Doxygen中拆分typedef导致签名相同的函数文档？

遇到这种因为typedef导致Doxygen把两个函数当成同一个的情况，有几个实用的方法可以让它们被识别为独立函数并生成各自的文档：

方法1：用\fn命令显式声明函数签名 #

这是最直接可靠的方式，通过在每个函数的文档块里明确指定完整的函数签名（包括typedef后的类型），让Doxygen清楚区分两个函数。

示例代码：

typedef int group;

/**
 * @fn void func(group x)
 * @brief 接收group类型参数的函数
 * @param x 类型为group的参数
 */
void func(group x) {
    // 函数实现
}

/**
 * @fn void func(int x)
 * @brief 接收int类型参数的函数
 * @param x 类型为int的参数
 */
void func(int x) {
    // 函数实现
}

\fn命令会强制Doxygen将该文档块与指定签名的函数关联，即使底层类型相同，也不会合并文档。

方法2：使用\distinctfrom命令标记差异 #

如果你的Doxygen版本支持（较新版本已包含此特性），可以用\distinctfrom命令明确告诉Doxygen当前函数与另一个同名函数是不同的实体。

示例代码：

typedef int group;

/**
 * @brief 接收group类型参数的函数
 * @param x 类型为group的参数
 * @distinctfrom func(int)
 */
void func(group x) {
    // 函数实现
}

/**
 * @brief 接收int类型参数的函数
 * @param x 类型为int的参数
 * @distinctfrom func(group)
 */
void func(int x) {
    // 函数实现
}

这个命令会让Doxygen为两个函数生成独立的文档条目，同时在文档中提示它们的差异。

方法3：用命名组（\name）或锚点（\anchor）区分 #

通过给每个函数的文档块设置不同的命名组或锚点，也能让Doxygen将它们分开显示：

typedef int group;

/**
 * @name 处理group类型的函数
 * @anchor func_group
 * @brief 接收group类型参数的函数
 * @param x 类型为group的参数
 */
void func(group x) {
    // 函数实现
}

/**
 * @name 处理int类型的函数
 * @anchor func_int
 * @brief 接收int类型参数的函数
 * @param x 类型为int的参数
 */
void func(int x) {
    // 函数实现
}

这种方式会把两个函数归类到不同的命名组下，在文档中作为独立部分展示。

其中，方法1的兼容性最好，不管Doxygen版本新旧都能生效，是最推荐的解决方案。

内容的提问来源于stack exchange，提问作者Mark S