如何在Doxygen的\subsubsection中映射含函数指针参数的函数

我有一个带函数指针参数的C函数，代码及Doxygen注释如下：

/**
 * @brief Description of your function.
 * @param a arg1 pointer.
 * @param func Description of the function pointer argument.
 * @param c arg2 pointer.
 */

int MyFunc(int *a, Std_ReturnType (*func)(int* b), int* c);

我想在Doxygen自定义页面中通过\subsubsection映射该函数，写法如下：

\section mysection Page1 

\subsubsection MyFuncsubsec MyFunc(int* a, Std_ReturnType (*func)(int* b), int* c)
int MyFunc(int *a, Std_ReturnType (*func)(int* b), int* c)

但因为函数指针参数的存在，生成的文档中该函数名称没有生成跳转至定义的链接，而无函数指针参数的函数可以正常生成链接，请问如何正确用\subsubsection映射该函数？

方式一：直接用\ref引用函数名 #

这是最可靠的方式，利用Doxygen的\ref命令直接关联函数标识符（函数名），避免复杂签名解析的问题：

\section mysection Page1 

\subsubsection MyFuncsubsec \ref MyFunc

生成的子小节标题会直接显示函数名，且是可跳转至函数定义的链接。

方式二：显示完整签名同时保留链接 #

如果需要子小节标题显示完整函数签名，可结合\ref的别名功能，指定显示文本：

\section mysection Page1 

\subsubsection MyFuncsubsec \ref MyFunc "MyFunc(int* a, Std_ReturnType (*func)(int* b), int* c)"

这样标题会显示完整的函数签名，同时整个标题是可点击的跳转链接。

关键说明 #

Doxygen对带函数指针的复杂签名解析容易受格式细节（如空格、括号位置）影响，导致无法匹配函数定义。直接使用函数名作为\ref的目标，能绕过签名解析的问题，确保Doxygen正确关联到函数的定义文档。另外要确保函数所在文件已被包含在Doxygen的扫描范围内，且原有注释符合规范，保证函数定义已被Doxygen正确索引。

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