开发者

Why won't XML DOC comments in a C++ header generate output?

I have a C++ project that creates a DLL, let's call it my.dll. Along with it I supply a header named my.h which contains declarations of the functions exported from my.dll. The source code of my.dll #includes the my.h header. I've added XML DOC comments to the function declarations in my.h and set the /doc switch on the cl.exe command line. At compile time one *.xdc file for each *.cpp f开发者_如何学Cile but none of them contain the XML DOC comments found in my.h.

It appears the /doc switch on cl.exe only processed XML DOC comments from c/c++ files. Is this true? If not, how to I get it to process XML DOC comments in a header file?


For in-code documentation, I strongly recommend doxygen (uses javadoc format) rather than the proprietary xmldoc format.

0

上一篇:

下一篇:

精彩评论

暂无评论...
验证码 换一张
取 消

最新问答

问答排行榜