I'm struggling to get my code comments to appear in Doxygen's generated documentation. I've been using the Doxygen wizard and the C language. Here's an example comment:
/**
* 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(...) { ...}
The opening comments show up as expected. Here's the header comment at the beginning of the file:
/**
* @file
* @brief A super great file.
* @author Tinus Lorvolds
*/
JAVA_AUTOBRIEF is on. Doxyfile version 1.8.14 on Windows 7 with C source files. I'm sure this is something simple, but I've been stuck on it for quite awhile. Thank you for your help and patience.
Here's the relevant diff between my configuration and the standard one:
OPTIMIZE_OUTPUT_FOR_C = YES
JAVADOC_AUTOBRIEF = YES
EXTRACT_STATIC = YES
RECURSIVE = YES
Solution below.
The issue was with the source itself. A preprocessor directive was hiding the source from Doxygen. If the settings listed above are all set correctly, try disabling this feature:
ENABLE_PREPROCESSING = NO