[Doxygen-users] Documentation Blocks in Macros
Brought to you by:
dimitri
|
From: <joh...@uk...> - 2001-08-08 14:39:57
|
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 |