GNOME Bugzilla – Bug 769736
doxygen generates incorrect documentation for C enum in latex
Last modified: 2016-09-05 13:45:45 UTC
Problem is that doxygen adds \\* after enum values documentation in latex output. When ENUM_VALUES_PER_LINE is set to 1 this symbol(\\*) prohibits a page break and enum values documentation goes beyond page, page bottom margin and most of it gets lost. My code looks like: /*! * @brief Brief enum description */ enum EnumName { EnumName_EnumVal1 = SOME_MACRO(1), /**< EnumName_EnumVal1 description */ EnumName_EnumVal2 = SOME_MACRO(2), /**< EnumName_EnumVal2 description */ EnumName_EnumVal3 = SOME_MACRO(3), /**< EnumName_EnumVal3 description */ (more values - enough to fully cover 2-3 A4 pages) EnumName_Last /**< EnumName_EnumVal description */ } I think problem is with if-else in function: latexgen.cpp:2127: void LatexGenerator::lineBreak(const char *) since \\* is generated by its else branch.
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.12. 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 (preferably in the form of a self-contained example).