Bill Tribley

I have an embedded system written in C with Doxygen comments. For C/C++ code standard practice is to document in the headers so the code doesn't clutter the docs and the header file functions as a reference guide. In my code a number of utility functions are split across several files (util.c/h, stdproj.c/h, chgmgt.c/h) and included by a lot of files. Some like util.h are properly documented but stdproj.h content is skipped even though util.h appears later in the preprocessor debug output. I have...

I have an embedded system written in C with Doxygen comments. For C/C++ code standard practice is to document in the headers so the code doesn't clutter the docs and the header file functions as a reference guide. In my code a number of utility functions are split across several files (util.c/h, stdproj.c/h, chgmgt.c/h) and included by a lot of files. Some like util.h are properly documented but stdproj.h content is skipped even though util.h appears later in the preprocessor debug output. I have...