doxygen - Doxygen 功能自动链接问题

Question

在我的 C 程序的 .h 文件中，我有一个函数：

/** Calculates foo using algorithm A1.
 * \param[in] v1 first input
 * \param[in] v2 second input
 * \param[in] s1 first string
 * \param[in] s2 second string
 * \return foo(v1,v2)
 */
int foo( int v1, int v2, char *s1, char *s2);

现在我想在文件的开头讨论这个函数。所以我说：

/** To facilitate such operations I have:
 *  @li int foo( int v1, int v2, char *s1, char *s2)
 * 
 *  which allows me to blah.
 */

现在在我的 doxygen 文件中，单词foo没有链接到最后的函数定义部分。但是，如果我说：

/** To facilitate such operations I have:
 *  @li int foo()
 * 
 *  which allows me to blah.
 */

自动链接工作正常。包括参数会破坏自动链接功能，我一生都无法弄清楚原因。这发生在我所有具有 > 1 个输入参数的函数上。foo()和foo(int i)工作，但foo(int i, int j, int k, int m)不工作。有谁知道为什么会这样？

标签： doxygen