Handling two different functions with the same name in Doxygen

Question

I have a C project which contains two functions with the same name, but each is within a different group/module (@defgroup).

These functions each compil

Answer 1

can this work for you?

The example is stripped down to the two files a.c and b.c, with only one function (the clashing) function.

file a.c

/**
 * \defgroup agroup Group A
 */

/** 
 * the function in a, 
 * see also \link b.c myfunc() \endlink the other one 
 * \ingroup agroup
 */
void myfunc() {
    ;
}

file b.c

/**
 * \defgroup bgroup Group B
 */

/** 
 * the function in b, 
 * see also \link a.c myfunc() \endlink the other one 
 * \ingroup bgroup
 */
void myfunc() {
    ;
}

as you see, myfunc() has a name clash. I placed a link to the other function in the documentation.

I perpended the function name by the filename.

I compiled it with doxygen and the links worked (they linked from each documentation of a function to the other function).