GNOME Bugzilla – Bug 604412
DISTRIBUTE_GROUP_DOC uses the comment from the first group in all subsequent groups
Last modified: 2009-12-17 12:38:21 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.
This appears to be a duplicate of bug #593040.
*** This bug has been marked as a duplicate of bug 593040 ***