GNOME Bugzilla – Bug 308695
doxygen leaves out some documented files and functions in C mode
Last modified: 2006-07-07 02:48:45 UTC
Please describe the problem: [forwarded from http://bugs.debian.org/312485 ] bug submitter writes: Package: doxygen Version: 1.4.2-4 Severity: important While using the previous version of doxygen which was available via apt-get, my project has been documented by doxygen without any problems. Since I have the new version for a couple of days, I now realize that doxygen leaves out parts of the documentation. This are sometimes only some functions but also complete files. While in the log the files appear to be found and parsed, no documentation for them is generated. I compared a functions documentation that has been generated properly with a functions documentation that has been left out, but I didn't notice any major differences between them. I wounder if this problem could be related to Bug 306710 for doxygen in bugzilla.gnome.org Steps to reproduce: 1. 2. 3. Actual results: Expected results: Does this happen every time? Other information:
It is possible that something like this could have happened in 1.4.2, but without a supporting example I cannot verify this. I suggest to try the reproduce this problem with the latest CVS snapshot and if it is still present then attach an example to this bug report that allows me to reproduce it.
Created attachment 48421 [details] Testcase with all additional files for test with latest version and 1.4.1 Contains all files for a testcase on doxygen 1.4.1 and doxygen 1.4.3-20050623 (latest CVS snapshot) to see that a formula, that compiles perfectly in version 1.4.1, leads to omit parts of the documentation in newer versions.
While I was trying to downsize the respective files that are having problems, I found that the error seems to reside in the formula parsing of doxygen. The two files attached have been reduced to a minimum so both problems can be seen. Trying to produce latex output with doxygen 1.4.1 works fine, while the latest CVS snapshot 1.4.3-20050623 had the following errors: File: formulas1.c -- will not be added to the doxygen output when the two formulas are kept within the documentation. File: fomrulas2.c -- the problem is somewhere in the two comment blocks within the function itself. While the first function will be parsed and at least the brief and the detailed description of the function itself will be written to the respective file while everything which follows the first comment will be left out by doxygen.
It seems that this bug does not occur in one of the latest versions of doxygen (tested with 1.4.6). Both test files formulas1.c and formulas2.c are processed correctly by doxygen.
Andreas, thanks for the feedback. Closing FIXED as per comment 4.