Recommended tags for documentation comments
The MSVC compiler processes documentation comments in your code to create an XDC file for each compiled source file. Then, xdcmake.exe processes the XDC files to create an XML documentation 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.
Note
Documentation comments can't be applied to a namespace or on out of line definitions for properties and events; documentation comments must be 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>
- Compiler verifies syntax.
In the current release, the MSVC compiler doesn't support <paramref>
, a tag that's supported by other Visual Studio compilers. Visual C++ may support <paramref>
in a future release.
See also
Зворотний зв’язок
https://aka.ms/ContentUserFeedback.
Очікується незабаром: протягом 2024 року ми будемо припиняти використання механізму реєстрації проблем у GitHub для зворотного зв’язку щодо вмісту й замінювати його новою системою зворотного зв’язку. Докладніше:Надіслати й переглянути відгук про