GNOME Bugzilla – Bug 754184
\bug paragraph doesn't end with a new sectioning command
Last modified: 2015-12-30 10:18:59 UTC
This bug can be seen in the example output for the command \author in doxygen's manual pages: The warning and copyright paragraphs are nested into the bug paragraph. Here is the link to the respective online manual's page: http://www.stack.nl/~dimitri/doxygen/manual/examples/author/html/class_some_nice_class.html The bug seems to occur with most sectioning commands that follow directly at the next line after the \bug command.
Looks like the problem appeared first time in the version 1.8.6 after the @parblock command has been introduced. Offending code in commentcnv.l (git reference: September 24 2013, 3b9f4d9cee85686861070c68a53c9db369589a6e) looks like to be: if (cmdPtr->endsBrief && inContext!=OutputXRef) when removing the: && inContext!=OutputXRef the output looks like the 1.8.5 output again, but I'm not sure about any side effects. A workaround for this problem is to put an empty line before (in this case) the \warning command. (the documentation states: The \bug command ends when a blank line or some other sectioning command is encountered. looks like the later does not work any more).
I agree that this is a bug. The mentioned change was done to support this case, where the @parblock should become part of the @todo. /** * Text * @todo * @parblock * First paragraph * * Second paragraph * @endparblock * More text. */ We need to look for a better solution.
A fix has been committed to GitHub: https://github.com/doxygen/doxygen/commit/13e2b18c93df1351c4e91d13a7fe224b4841fa73
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.8.11. 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).