GNOME Bugzilla – Bug 730520
No documentation generated for method-less C++ struct
Last modified: 2014-08-21 17:15:41 UTC
It seems that if a struct (but not a class) has no constructor(s), nor destructor(s), nor methods then no documentation gets generated. Here is my doxygen_bug.hpp: ---------- struct Bar { int x; }; struct Foo { void m(); int x; }; struct Waz { int x; int y; }; ---------- Documentation gets generated for Foo but not for Bar nor Waz. I have doxygen images built from source snapshots on 4/7, 4/18, 4/28 and 5/13. All exhibit the same behavior. In case it is important here are my non-standard settings: ---------- ALPHABETICAL_INDEX = YES ALWAYS_DETAILED_SEC = YES BUILTIN_STL_SUPPORT = YES CALLER_GRAPH = YES CALL_GRAPH = YES # CLANG_ASSISTED_PARSING = YES COLS_IN_ALPHA_INDEX = 4 COMPACT_LATEX = YES DOT_IMAGE_FORMAT = svg DOT_MULTI_TARGETS = YES ENUM_VALUES_PER_LINE = 0 EXTENSION_MAPPING = cgr=C++,gt=C++ EXTRACT_ALL = YES EXTRACT_ANON_NSPACES = YES EXTRACT_PACKAGE = YES EXTRACT_PRIVATE = YES EXTRACT_STATIC = YES EXCLUDE = test tests FILTER_SOURCE_FILES = YES FORCE_LOCAL_INCLUDES = YES FULL_PATH_NAMES = NO GENERATE_LATEX = YES GENERATE_TREEVIEW = YES HAVE_DOT = YES HIDE_UNDOC_RELATIONS = NO HTML_DYNAMIC_SECTIONS = YES INLINE_INFO = NO INLINE_SIMPLE_STRUCTS = YES INTERACTIVE_SVG = YES JAVADOC_AUTOBRIEF = YES LATEX_BATCHMODE = YES LATEX_HIDE_INDICES = YES LOOKUP_CACHE_SIZE = 2 MACRO_EXPANSION = YES MAN_LINKS = YES MAX_DOT_GRAPH_DEPTH = 1000 PAPER_TYPE = letter PDF_HYPERLINKS = YES QUIET = YES RECURSIVE = YES REFERENCED_BY_RELATION = YES REFERENCES_LINK_SOURCE = NO REFERENCES_RELATION = YES SEPARATE_MEMBER_PAGES = YES SKIP_FUNCTION_MACROS = NO SORT_MEMBERS_CTORS_1ST = YES SOURCE_BROWSER = YES STRIP_CODE_COMMENTS = NO SUBGROUPING = NO TAB_SIZE = 8 TEMPLATE_RELATIONS = YES TOC_EXPAND = YES USE_HTAGS = YES USE_PDFLATEX = YES ----------
Seems to be caused by the following combination of settings SEPARATE_MEMBER_PAGES = YES INLINE_SIMPLE_STRUCTS = YES Switching any of the two off will work around the problem.
Should be fixed in the next GIT update.
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.8.8. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant (preferrably in the form of a self-contained example).