c - 处理 doxygen 中的长链接

Question

给定一个带有长参数列表的函数声明，例如:

uint8 rtSetTime(RTIME *rtime, uint8 day, uint8 month, uint16 year,
    uint8 hour, uint8 minute, uint8 second);

有没有办法将参数列表拆分成多行，这样 doxygen 仍能正确解析 @link 命令？目前，如果函数声明在一行上，我只能让它工作，即:

@link rtSetTime(RTIME *rtime, uint8 day, uint8 month, uint16 year, uint8 hour, uint8 minute, uint8 second) rtSetTime @endlink

Answer 1

永远不要在链接中使用参数名称。假设 rtSetTime 不是重载函数，也不需要指定所有参数类型。

这里有许多链接到函数的方法，从最短到最长。最后两个在函数重载的情况下也有效。

/** @mainpage 
 *  - #rtSetTime 
 *  - @ref rtSetTime "rtSetTime"
 *  - @ref rtSetTime() "rtSetTime"
 *  - @link rtSetTime rtSetTime@endlink 
 *  - @link rtSetTime() rtSetTime@endlink
 *  - @ref rtSetTime(RTIME*,uint8,uint8,uint16,uint8,uint8,uint8) "rtSetTime"
 *  - @link rtSetTime(RTIME*,uint8,uint8,uint16,uint8,uint8,uint8) rtSetTime @endlink
 */