GNOME Bugzilla – Bug 746419
\todo at end of C# XML comment breaks following todo's
Last modified: 2018-07-30 10:33:05 UTC
Created attachment 299764 [details] Example C# file with a working and broken \todo command. When using C# XML documentation comments, the \todo command must be followed by a blank comment line. Otherwise, each of the remaining todo's in the code base will cause the following to be output by Doxygen, and the formatting of the remaining todo's on the todo page is lost: ASSERT: "0" in ..\src\docparser.cpp (5666) todo:2: warning: Unexpected tag <dd> found
Hi Arthur, I didn't manage to trigger the assert or the warning while running doxygen-1.8.9.1 on your example using a default configuration file. Can you please attach a more complete example (source + config file in a zip or tar) for which you verified it triggers the problem?
Created attachment 302444 [details] Input, config, stdout & stderr from run, and output showing bug. Sorry, I didn't realize it wasn't exactly the default config. I've included the result of "doxygen > build.log 2>&1" as well so you can see what happens for me. Thanks for looking in to this!
Created attachment 372119 [details] minimal working example
Hello With Doxygen 1.8.14 I have the same issue with the \todo command being used inside C# XML comments. Warnings are generated inside the log-file: "warning:Unexpected tag dd found" Except the warning, the problem is that the HTML output of the TODO list (at "related pages") is damaged. Note that technically the TODO list is made from a HTML "description list" which may explain the mysterious warning about the <dd> tag. I have attached a minimal working example. I can confirm that entering a empty comment line after the \todo mysteriously improve the situation. In my example code entering an empty comment line between line 38 and 39 is kind of work around. My suspicion is that Doxygen misses to "close" the \todo block at the moment when the </remarks> end-tag appears. best regards Clemens
I've just pushed a proposed patch to github (pull request 728, https://github.com/doxygen/doxygen/pull/728).
*** Bug 780174 has been marked as a duplicate of this bug. ***
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!