doxygen不能生成注释，请教高手？

Question

请问我注释格式写好了，doxygen在没有参数的函数可以生成注释，有参数的函数不能生成注释，怎么回事？

Answer 1

刚从同一个坑里出来，给其他掉坑里的人回下。
只有不带参数的函数生成注释，有参数的函数不能生成注释，
应该是用了 @fn 指明函数，但是仅仅指明了函数名称，没有将函数的返回值和参数全部列出来。

doxygen 规定在 @fn 后面必须列出函数的完整声明。
另外在函数上方的注释，doxygen 建议不用 @fn 再次指明，我把 @fn 全删了就能正常生产注释了。