问题
I have a c# project that I need to document with doxygen. It picks up the comments autogenerated by visual studio's ///
but unfortunately it does not pick up on the normal //
comments. Is there a config setting that I am missing? Or is this just not possible?
回答1:
///
is referred to as XML Documentation Comments. This is how Doxygen and other documentation-generating software locate areas of the code you want to be used as documentation.
To elaborate, if you have comments like // This is hacky, but I'll return to it later
in your code you should change them to an XML comment section on the method, property, or object in question.
回答2:
To me this is not a bug but a feature. There are comments that I do want to leave in the code and not extract and show everyone. The distinction between the /// and the // allows me to do this.
来源:https://stackoverflow.com/questions/9176893/comments-in-doxygen