c - 非标准的特殊文档 block 和 doxygen

Question

我正在使用第 3 方 API C 源，其中特殊文档 block 如下所示

/****************************************************************************************
 * @fn          fn
 *
 * @brief       brief
 *
 * @param       param
 *
 * @return      return
 ****************************************************************************************
 */
void fn(void)
{
 ...
}

有没有办法让 Doxygen 相信这些是真正的特殊文档 block ，而无需修改源代码以匹配标准 block (例如， block 开始处恰好有两个星号)？

提前谢谢你。

Answer 1

我建议创建一个输入过滤器，将 /****** 替换为 /** 并将其添加到 INPUT_FILTER配置文件中的选项。如果您的系统上有 Unix 命令 sed，下面的命令可以解决问题:

INPUT_FILTER           = "sed -e 's|/\*\*\**|/**|g'"