After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 684324 - Strange behavior when placing cite within brief.
Strange behavior when placing cite within brief.
Status: RESOLVED FIXED
Product: doxygen
Classification: Other
Component: general
1.8.2
Other Linux
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
: 700788 (view as bug list)
Depends on:
Blocks:
 
 
Reported: 2012-09-18 20:00 UTC by Jesper Brynolf
Modified: 2013-09-16 17:19 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
An archive containing test.h, Doxyfile and testref.bib. Using this file to generate html and latex output illustrates the problem well. (22.33 KB, application/x-gzip)
2012-09-18 20:00 UTC, Jesper Brynolf 		Details

Description Jesper Brynolf 2012-09-18 20:00:05 UTC 
Created attachment 224665 [details]
An archive containing test.h, Doxyfile and testref.bib. Using this file to generate html and latex output illustrates the problem well.

I have been using the cite command together with brief within a few different doxygen comment context such as module, class, struct, function and typedef. The comments resides within C++ code.

Examples:

/**
 * \defgroup grp1 Group 1
 *
 * \brief Foo bar see \cite report:FooBar
 *
 * Detailed foo bar.
 */

And the result I get is that the cite and everything written after it in the brief ends up in detailed description section of the different contexts and it is no difference between the Latex and the HTML output.
Comment 1 Jesper Brynolf 2013-02-03 16:35:49 UTC 
I have tested this with 1.8.3.1 on Ubuntu 12.10 and the strange behavior still remains.
Comment 2 Jesper Brynolf 2013-05-24 16:42:09 UTC 
I have tested this with 1.8.4 in RedHat 5.6 and the issue still remains.

/**@brief See \cite report:FooBar
 *
 * Detalied foo bar.
 */
class FooBar
{
FooBar();
virtual ~FooBar()
};

This results in the following PDF

...
X.X FooBar Class Reference
See
X.X.1 Detailed Description
[1].
Detailed foo bar.
Comment 3 Dimitri van Heesch 2013-05-30 19:32:16 UTC 
Confirmed. Should be fixed in the next GIT update.
Comment 4 Dimitri van Heesch 2013-05-30 19:33:46 UTC 
*** Bug 700788 has been marked as a duplicate of this bug. ***
Comment 5 Dimitri van Heesch 2013-08-23 15:04:31 UTC 
This bug was previously marked ASSIGNED, which means it should be fixed in
doxygen version 1.8.5. 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.
Comment 6 Jesper Brynolf 2013-09-16 17:19:44 UTC 
Tested it with doxygen 1.8.5 on Xubuntu 13.04 and it worked perfectly.