GNOME Bugzilla – Bug 646002
htmlonly content appears in generated XML output
Last modified: 2015-12-30 10:19:01 UTC
The Doxygen docs state that the \htmlonly tag starts a block of text that will be verbatim included in the generated HTML documentation only. However, the content appears in the generated XML documentation, too. It is encased in <htmlonly> and </htmlonly> tags. Shouldn't the content be ignored altogether as it's being generated? Also, in the Doxygen docs, the link to the \endhtmlonly topic under the \htmlonly topic doesn't work.
I can confirm this. Any resolution on the horizon?
According to the documentation the @htmlonly (and other *only marked documentation) should not appear. For the other output formats this works. I've just pushed a proposed patch (pull request 381) to github. In case the old behavior should be maintained, i.e. in the xml file also the other *only documentation should appear, the documentation of the different commands has to be adjusted and I think it would be better that the code inside e.g. <htmlonly> .. </htmlonly> (etc.) should be placed in CDATA constructs to overcome possible incorrect XML code resulting from the other *only constructs.
Code has been integrated in github
This bug was previously marked ASSIGNED, which means it should be fixed in doxygen version 1.8.11. Please verify if this is indeed the case. Reopen the bug if you think it is not fixed and please include any additional information that you think can be relevant (preferably in the form of a self-contained example).