Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

/doc (Process Documentation Comments) (C/C++)

Causes the compiler to process documentation comments in source code files and to create an .xdc file for each source code file that has documentation comments.

/doc[name]
name

The name of the .xdc file that the compiler will create. Only valid when one .cpp file is passed in the compilation.

The .xdc files are processed into an .xml file with xdcmake.exe. For more information, see XDCMake Reference.

You can add documentation comments to your source code files. For more information, see Recommended Tags for Documentation Comments (Visual C++).

/doc is not compatible with /clr:oldSyntax. See /clr (Common Language Runtime Compilation) for more information.

To use the generated .xml file with IntelliSense, make the file name of the .xml file the same as the assembly that you want to support and put the .xml file is in the same directory as the assembly. When the assembly is referenced in the Visual Studio project, the .xml file is also found. For more information, see Using IntelliSense and Supplying XML Code Comments.

To set this compiler option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see How to: Open Project Property Pages.

  2. Expand the Configuration Properties node.

  3. Expand the C/C++ node.

  4. Select the Output Files property page.

  5. Modify the Generate XML Documentation Files property.

To set this linker option programmatically

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.