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 604412 - DISTRIBUTE_GROUP_DOC uses the comment from the first group in all subsequent groups
DISTRIBUTE_GROUP_DOC uses the comment from the first group in all subsequent ...
Status: RESOLVED DUPLICATE of bug 593040
Product: doxygen
Classification: Other
Component: general
1.6.1
Other Linux
: Normal normal
: ---
Assigned To: Dimitri van Heesch
Dimitri van Heesch
Depends on:
Blocks:
 
 
Reported: 2009-12-11 23:50 UTC by Marcus D. Hanwell
Modified: 2009-12-17 12:38 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Minimal example directory with doxyfile and one header (3.60 KB, application/x-compressed-tar)
2009-12-11 23:50 UTC, Marcus D. Hanwell
Details

Description Marcus D. Hanwell 2009-12-11 23:50:41 UTC
Created attachment 149617 [details]
Minimal example directory with doxyfile and one header

VTK uses doxygen to generate its API documentation. I found bug 
312655 and I wonder if the fix for that bug might have caused the bug observed in the new nightly VTK documentation.

We use groups and rely on the DISTRIBUTE_GROUP_DOC directive to reuse the first comment in a group for subsequent functions. For example,

http://www.vtk.org/doc/release/5.4/html/a00998.html

After upgrading doxygen you can see that the first comment in the first group is reused for all subsequent comments in subsequent groups for functions with no documentation,

http://www.vtk.org/doc/nightly/html/classvtkMatrix4x4.html

I have verified this is the case with a minimal example I have attached. I think our use of the tag was correct, but this behavior is now broken. See how "Matrix Inversion (adapted from Richard Carling in "Graphics Gems," Academic Press, 1990)." is reused in each function group below it.

Running doxygen in the attached example should demonstrate this.
Comment 1 Erik Zeek 2009-12-14 18:22:02 UTC
This appears to be a duplicate of bug #593040.
Comment 2 Marcus D. Hanwell 2009-12-17 12:38:21 UTC

*** This bug has been marked as a duplicate of bug 593040 ***