我正在尝试记录一个C API,它包含在一个C头文件中.当我在文件上运行doxygen时,它给了我当前未记录的C宏的错误,但是当我为宏添加必要的文档时,虽然清除了未记录的错误,但是在doxygen生成的html输出中没有出现宏加文档.
只有一小部分记录的头文件,即结构,实际上出现在任何doxygen输出中.我在配置设置或文档中看不到任何有助于澄清为什么doxygen不会将头文件中的文档代码放入其生成的输出中的内容.
有人知道为什么会这样吗？
请参阅常见问题解答的第 2 项和第 3 项：http://www.doxygen.org/manual/faq.html
简而言之，您可能缺少一个注释块来@file记录您的头文件。