|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.|
Recommended Tags for Documentation Comments (Visual C++)
The Visual C++ compiler will process documentation comments in your code and creates an .xdc file for each compiland, and xdcmake.exe will process the .xdc files to an .xml file. Processing the .xml file to create documentation is a detail that needs to be implemented at your site.
Tags are processed on constructs such as types and type members.
Tags must immediately precede types or members.
Documentation comments cannot be applied to a namespace or on out of line definition for properties and events; documentation comments must on the in-class declarations.
The compiler will process any tag that is valid XML. The following tags provide commonly used functionality in user documentation:
1. Compiler verifies syntax.
In the current release, the Visual C++ compiler does not support <paramref>, a tag that is supported by other Visual Studio compilers. Visual C++ may support <paramref> in a future release.