First of all, hello everyone! I'm trying out Doxygen 1.8.10 to generate doc for my C code. I'm a but stumped about two things, though. Example header:
/// @file /// My typedef. typedef void VOID; /// My simple function. Details. extern VOID Function(VOID); Note that I have enabled OPTIMIZE_OUTPUT_FOR_C, JAVADOC_AUTOBRIEF and enabled all warnings. The first thing is that Doxygen will generate doc for this function, but emit no warnings and also not create a link with details (whole line is read as brief). The problem goes away when there are at least two lines beginning with ///. I noticed documentation states that I need to make at least two lines in case of single-line comments. My question is: why? Is there a special reason for it? The second thing is that VOID typedef. When I add another /// line, Doxygen starts to emit warnings. However, it emits missing return value warning in this case (although there is no return value). Now, I understand it doesn't see "void" there. If I replace "VOID" with "void", it doesn't emit a warning. The problem is something else. I tried to fix this by ENABLE_PREPROCESSING = YES PREDEFINED = VOID=void It didn't seem to do anything, warning is still emitted. I also tried PREDEFINED = "VOID=void" Warning still emitted. Am I missing something? With kind regards, Bostjan ------------------------------------------------------------------------------ _______________________________________________ Doxygen-users mailing list Doxygen-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/doxygen-users
