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