Question

我很难让我的代码注释出现在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

以下解决方案。

Answer 1

问题在于源本身。预处理器指令隐藏了Doxygen的源代码。如果上面列出的设置都设置正确，请尝试禁用此功能：

ENABLE_PREPROCESSING   = NO

生成的Doxygen文档中缺少Javadoc样式注释

1 个答案: