[Doxygen-users] Documentation Blocks in Macros

[<joh...@uk...>]

Hi there

I'm using Doxygen with great effect to document and understand a large C
software project I'm porting. I find the macro expansion capability very
useful, as a lot of C structures are generated through macros. The struct
macro source is well commented, but the preprocessor removes the comments
when a struct is generated by macro expansion (the same behaviour as gcc's
cpp with the -C flag). How can I arrange that the comments are included in
the macro expansion so they are brought into the documentation? I've
thought of mapping /* to xxxxxx and */ to yyyyyy in an input filter which
would do the trick, but there is no post-preprocessing filter to put the
comments back again before further processing.

Another small point relating to macro expansion. The Doxygen preprocessor
doesn't expand macros in #include directives (eg #include SPECIAL where
SPECIAL = "myfile").

John Storrs