GNOME Bugzilla – Bug 153382
Automatically extract FIXME's.
Last modified: 2018-07-30 10:17:23 UTC
[forwarded from http://bugs.debian.org/122154 forwarded by email as well, but no trace in the BTS] bug submitter writes: I realise that doxygen has a facility for TODO items but these only seem to be extracted if they are listed in the doxygen comment block OUTSIDE of a function definition. I don't think I'm unique in that I put FIXME comments at the location of the potential problem. It'd be lovely if doxygen had an option to extract these FIXME's and list them both as part of the class/individual source documentation and to generate a project-wide list akin to how the TODO functionality work.
Actually, doxygen does support this to some extent. If you put the detailed documentation comment in the source file, it will pick up \todo commands mixed in the function definition just like you want. But, if you put the detailed comment in the header file, it won't work. This is because doxygen only allows a single detailed comment. See bug #163033.
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!