Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Documentation not appearing in doxygen output

Tags:

doxygen

I'm trying to document a C API which is all contained in a single C Header file. When I run doxygen, on the file, it's giving me errors for currently undocumented C Macros, but when I add the necessary documentation for macros, although the undocumented errors are cleared, the macros plus documentation do not appear in the doxygen generated html output.

Only a fraction of the documented header file, the structures, actually appears in any doxygen output. I can't see anything in configuration settings or documentation that would assist in clarifying why doxygen does not place documented code from the header file into its generated output.

Does anybody know why this would be the case?

like image 425
jwhitmore Avatar asked Sep 07 '13 15:09

jwhitmore


People also ask

How do I show code in Doxygen?

You can put example source code in a special path defined in the doxygen config under EXAMPLE_PATH , and then insert examples with the @example tag. Doxygen will then generate an extra page containing the source of the example. It will also set a link to it from the class documentation containing the example tag.

How long does Doxygen take?

Doxygen takes about 12 hours to run on our code base. This is primarily because there is a lot of code to process (~1.5M lines).

Should Doxygen comments be in header or source?

The common sense tells that the Doxygen comment blocks have to be put in the header files where the classes, structs, enums, functions, declarations are. I agree that this is a sound argument for a libraries that are mean to be distributed without its source (only headers and libs with object code).


1 Answers

See items 2 and 3 of the FAQ: http://www.doxygen.org/manual/faq.html

In short you are likely missing a comment block with @file to document your header file.

like image 165
doxygen Avatar answered Sep 20 '22 22:09

doxygen