GNOME Bugzilla – Bug 304377
Hide field detail in HTML output when detail absent
Last modified: 2005-05-16 20:41:12 UTC
Version details: 1.4.2 If a C structure has only a brief documentation comment, the field specific documentation could be omitted. e.g. (using JAVADOC_AUTOBRIEF=YES) typedef struct ExampleTag { /** Good variable. * This variable is very good. */ int goodCount; /** Bad variable */ int badCount; } Example; In the above example, both goodCount and badCount will get an entry in the "Data Fields" section of the output HTML and but both variables will have links to "Field Documentation", which in the case of badCount will be blank. The output could be more concise if an option to hide "Field Documentation" when only brief docs are present was available.
Ha! EXTRACT_ALL was set to YES causing all fields to generate documentation despite the lack of a detailed description in the source I was processing. So this is not a mistake and is actually documented in the Doxygen manual as being the desired behaviour. Appologies for my foolishness....