具有相似签名的变体 C 函数的 Doxygen 注释

Question

我正在用 C 语言编写程序。由于该语言的静态类型，因此有必要按以下方式复制函数：

void foo_8(uint8_t thingy);
void foo_16(uint16_t thingy);
void foo_32(uint32_t thingy);

当涉及到 doxygen 评论时，您不得不多次复制粘贴相同的评论块。 doxygen有没有facilities/tags说"This function is the same as another focuntion"？

Answer 1

您可以使用 copydoc, copybrief or copydetails :

  \copydoc foo_8()

或

  \brief \copybrief foo_8()
  \details \copydetails foo_8()