C#程序员可以用三个斜杠来开始XML格式的注释,而且编译器可以据此生成可用于自动生成帮助文档的XML文件。Visual C++ 2005中的编译器也支持了这个功能,而且对非托管函数也生效,前提是必须打开/clr和/DOC开关,并且不能使用/clr:oldSyntax开关编译。
![]()
/**/ ///
///Use two bubble sort steps
///to show the performance information
///of different function calls.
///
![]()
int main(array < System::String ^> ^ args)
... {
bubbleSort<bubble1>(ARRAY_SIZE);
bubbleSort<bubble2>(ARRAY_SIZE);
return 0;
}
#pragma unmanaged
/**/ ///
///testing unmanaged function...
///
int foo()
... {
return 0;
}
有空的话,多去微软的反馈中心提提对产品的建议是很有好处的……
参考
- /doc (Process Documentation Comments) (C/C++)( http://msdn2.microsoft.com/en-us/library/ms173501.aspx )
- XML Comments for Managed C++ Applications (http://www.codeproject.com/dotnet/MCXDoc.asp)
- NDoc Code Documentation Generator for .NET(http://ndoc.sourceforge.net)