GNOME Bugzilla – Bug 709226
Struct member fields not documented with INLINE_SIMPLE_STRUCTS
Last modified: 2016-11-12 18:40:54 UTC
Created attachment 256210 [details] Minimal input file Hello, The structures are not fully documented when INLINE_SIMPLE_STRUCTS is enabled. I'm attaching a simple test file (teststruct.h) and a minimal Doxyfile that will generate a man page, LaTeX and HTML. In all cases, the structure's members are not documented, whereas disabling INLINE_SIMPLE_STRUCTS produces a dedicated page or section where the fields appear. This bug was already present at least in version 1.8.3 (tested with Fedora 18's package).
Created attachment 256211 [details] Minimal Doxyfile
Created attachment 257056 [details] Updated minimal input file So after further investigation (please see the corresponding Debian bug [1]), it appears that this problem comes from the fact that only the long description is used and the brief description is ignored. The attached file (teststruct2.h) shows what really happens. Although this work-around is enough, IMO this behaviour should still be considered as a bug. [1] http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=725122
Confirmed. 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.6. 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).
Thanks for looking into this. It now works as it should for teststruct2.h (i.e. when both brief and long descriptions are provided). Unfortunately, the fix is incomplete, as it doesn't work with the initial teststruct.h. After investigation, it seems that it doesn't work when all the fields have only brief descriptions, but works for all the fields if at least one of them have a long description. Tested with Doxygen 1.8.6 on Debian sid.
I could reproduce this with 1.8.6 indeed, but not with any later version. Please reopen this bug report if you still see this issue with the latest version of doxygen.