Partager via

Recommended Tags for Documentation Comments (Visual C++)

  • Article

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.

Notes

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:

<c>

<code>

<example>

<exception>1

<include>1

<list>

<para>

<param>1

<paramref>1

<permission>1

<remarks>

<returns>

<see>1

<seealso>1

<summary>

<value>

 

 

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.

See Also

Other Resources

XML Documentation (Visual C++)