我正在努力让我的代码注释出现在 Doxygen 生成的文档中。我一直在使用 Doxygen 向导和 C 语言。这是一个示例评论:
/**
* Takes string formatted plugin information and processes it.
* @param id_orig a constant
* @param group_orig a constant
* @see get_or_add_info(...)
* @return SUCCESS and FAILURE macros.
*/
static RETCODE import_process_element(...) { ...}
开头的评论按预期显示。这是文件开头的标题注释:
/**
* @file
* @brief A super great file.
* @author Tinus Lorvolds
*/
JAVA_AUTOBRIEF
开启。带有 C 源文件的 Windows 7 上的 Doxyfile 版本 1.8.14。我敢肯定这很简单,但我已经坚持了很长时间。感谢您的帮助和耐心。
这是我的配置和标准配置之间的相关差异:
OPTIMIZE_OUTPUT_FOR_C = YES
JAVADOC_AUTOBRIEF = YES
EXTRACT_STATIC = YES
RECURSIVE = YES
下面的解决方案。