This document has been taken from the NDoc (GPL) documentation.
Section tags are used to define the content of the different sections of the documentation of a type or member.
These tags are used as top-level tags.
Tag | Description |
---|---|
<event> |
Use this tag to declare events that are raised by a member. Syntax: '''<event cref="EventName">
''' Raised when something occurs.
'''</event>
|
<example> |
Example section. See Microsoft's definition. |
<exception> |
Declares an exception that a member might throw. See Microsoft's definition. |
<include> |
References an xml node in an include file that contains one or more documentation section tags. See Microsoft's definition. |
<overloads> |
This new tag allows providing documentation that applies to all the overloads of a member. It only needs to be specified on the first overload. The <overloads> tag can have two forms:
Example: '''<overloads>This method has two overloads.</overloads> '''<summary>This overload just says hello.</summary> public void SayHello() { ... } '''<summary>This one says hello to someone.</summary> public void SayHello(string toSomeone) { ... } |
<param> |
Defines a member parameter. See Microsoft's definition. |
<permission> |
Define access permissions. See Microsoft's definition. |
<remarks> |
Remarks section. See Microsoft's definition. |
<returns> |
Defines a member's return value. See Microsoft's definition. |
<seealso> |
Adds a link to the See Also section. See Microsoft's definition. Do not include this tag in the <remarks> section. Alternate syntax:
|
<summary> |
The summary section. See Microsoft's definition. |
<value> |
Defines a property value. See Microsoft's definition. |
Block tags are typically used inside <remarks> and <example> sections to add structure to the text.
Tag | Description |
---|---|
<code> |
Code block. See Microsoft's definition. To avoid indentation problems, it is recommended to always place sections containing <code> blocks in an include file. |
<list> |
A definition list or table. See Microsoft's definition. |
<para> |
Delimits a text paragraph. See Microsoft's definition. |
Inline tags are typically used inside <para> blocks.
Tag | Description |
---|---|
<c> |
Marks inline code. See Microsoft's definition. |
<paramref> |
A reference to a parameter. See Microsoft's definition. |
<see> |
Inline reference to another member or type. See Microsoft's definition. Alternate syntax:
|