带有 doxygen 的 ISR 文档

Question

我有一些 ISR，但我真的不知道如何用 doxygen 记录它们。 你有什么想法吗？

举个例子。 doxygen 是否有任何特殊代码来记录这一点？

ISR(usartTimer_OVF_vect){
    usartData.flag_send_data = TRUE;
}

Answer 1

直接这是不可能的，因为它不是有效的 C，但通过解决方法它是可能的。

#if defined(__DOXYGEN__)
void usartTimer_OVF_Vect(void)
#else
ISR(usartTimer_OVF_vect)
#endif
{
    usartData.flag_send_data = TRUE;
}

在这种情况下，doxygen 只会看到一个名称为 usartTImer_OVF_Vect 且没有任何参数的 void 函数。