/doc(处理文档注释)(C/C++)
更新:2007 年 11 月
使编译器对源代码文件中的文档注释进行处理,并为每个具有文档注释的源代码文件创建一个 .xdc 文件。
/doc[name]
参数
- name
编译器将创建的 .xdc 文件的名称。仅在将一个 .cpp 文件传入编译时有效。
备注
使用 xdcmake.exe 将 .xdc 文件处理为一个 .xml 文件。有关更多信息,请参见 XDCMake Reference。
可以将文档注释添加到源代码文件中。有关更多信息,请参见Recommended Tags for Documentation Comments (C++)。
/doc 与 /clr:oldSyntax 不兼容。 有关更多信息,请参见 /clr(公共语言运行库编译)。
若要在 IntelliSense 中使用生成的 .xml 文件,就要使 .xml 文件与要支持的程序集具有相同的文件名,并使 .xml 文件与该程序集处于同一目录中。当在 Visual Studio 项目中引用该程序集时,也可以找到该 .xml 文件。有关更多信息,请参见使用 IntelliSense和提供 XML 代码注释。
在 Visual Studio 开发环境中设置此编译器选项
打开该项目的“属性页”对话框。有关详细信息,请参见如何:打开项目属性页。
展开“配置属性”节点。
展开“C/C++”节点。
选择“输出文件”属性页。
修改“生成 XML 文档文件”属性。