[Doxygen-users] Two strange things about Doxygen and my code

[Bostjan M. <cco...@gm...>]

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