对于C#,写程序时的XML 文档已经成为一个极大的助手,对我来说它不是可有可无的东西,但一直以来没敢奢望C++中有同样丰富的东西: 给定几乎任何一个程序中的元素, 你可以在定义它的时候写上足够丰富详实的信息, 以帮助你自己(或你的同事)几天、几星期、几个月以后非常方便地从中撷取有用的信息。
MSDN中的的一句话打消了我的顾虑:()
XML documentation can be used regardless of whether you compile with or without /clr.
我最需要对native 的C++类也支持此功能。VS中对C++的支持已经比C#少太多, 还好这个功能是有的,不过 Intellisense好像只有把项目编译之后才能出来,而不是象在C#中那样,这边写上,那边立即就能用R#的CTRL+Q看到结果。
接下来希望尝试一下。项目配置中跟C#项目的配置一样了,都可以指定输出的XML文档,如果使用命令行。
cl /doc"test.xdc" test.cpp
注意 /doc后面没有:号。
生成的是个xdc文档, 不知道它是什么, 需要一个随VS IDE提供的xdcmake 工具把它转成XML, 转成XML之后的文件需要跟 Assembly同名, 且位于同一目录下, VS或其它工具才能顺利识别它。
xdcmake test.xdc
阅读(935) | 评论(0) | 转发(0) |