GNOME Bugzilla – Bug 727732
Nested C structures/unions does not work with groups
Last modified: 2015-06-26 19:06:22 UTC
Created attachment 273693 [details] Small group structure bug example When using nested C structures/unions with groups the nested structure/union does not use the group it was declared in e.g. "DummyGroup" in the following. Consider the following file (dummy.h): ------------- /** * @file group bug example * * SecondLevel_s is not placed in group DummyGroup */ /** @addtogroup DummyGroup Dummy group * @{ */ /** * Nested structure bug example */ struct FirstLevel_s { /** * Second level structure which is misplaced */ struct SecondLevel_s { int a; //!< Variable a int b; //!< Variable b } second; //!< Second level structure }; /** @} */ ------------- In this example "struct SecondLevel_s" documentation is not placed in the "DummyGroup". A workaround is to add "@ingroup DummyGroup", but this seems wrong as the group is already specified.
Confirmed. Should be fixed in the next GIT update.
Resolved, Thanks.
Is there a way to switch this behavior off? In 1.8.6 groups containing several complex classes were clean, but in 1.8.9 a lot of internal (nested) structures and enums are added to group making it hard to understand the bigger picture. Maybe it could be controlled with an option?
I'll add the option GROUP_NESTED_COMPOUNDS for this (default will be off)