GNOME Bugzilla – Bug 120637
Doc-comments not recognized
Last modified: 2009-08-15 18:40:50 UTC
Doxygen seems not to be recognizing some doc-comments, and I'm not sure why. I'll attach a test case.
Created attachment 19477 [details] Test case
I apologize for the lack of brevity/focus in the test case. However, attempts to condense it further changed the error messages in unexpected ways.
This problem should be fixed in the new CVS update. Could you check this for me?
I'm still seeing a few problems with this test case: * Doxygen issues this complaint, which suggests something is amiss with const handling: node.cpp:387: Warning: documented function `openvrml::node_interface_set::const _iterator' was not defined. node.cpp:93: Warning: Member const_iterator of class openvrml::node_interface_set is not documented. Note the space inserted in the first warning message. (node_interface::const_iterator does have a doc-comment.) * I get this warning, even though interface_id_matches_ is in an unnamed namespace and marked @internal. I have EXTRACT_STATIC set to NO and INTERNAL_DOCS set to NO. node.cpp:433: Warning: Compound openvrml::@2::interface_id_matches_ is not documented. * I get this warning: node.cpp:332: Warning: class `node_interface' for related function `operator!=' is not documented. ... because I haven't explicitly qualified node_interface in @relates. That is, if I said "openvrml::node_interface" instead, the warning would go away. But since the doc-comment is inside the openvrml namespace, I think I shouldn't have to do this.
Could you re-evalutate if these problems are still present in version 1.3.8 as I don't see them anymore...
Appears to be fixed.