Bill Tribley - 2022-05-06

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 attached the preprocessor output from doxygen debug, stdproj.h, util.h and my doxyfile.

Lines 3240 through 3525 are from stdproj.h and are blank. These lines are include-guarded; line 3526 shows the closing include guard line.

Lines 5474ff are from util.h . Most of this file is include-guarded as you can see because the final guard line is there in line 5583.

I have attached the two headers. In just about every respect they follow the same pattern of file comment, include guard (NAME_H ) and element documentation. I have searched all the code looking for STDPROJ_H (the include guard); that text only appears in file stdproj.h so this can't be a case of the same include guard text inadvertently placed in multiple files.

Any ideas as to why this is happening would be appreciated.

 

Last edit: Bill Tribley 2022-05-06
Doxyfile
qbcc doxygen preprocessor.txt
stdproj.h
util.h