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
 */