Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

What XML comment tags are supported in the Object Browser

I'd like to provide a higher level of detail at the class level (in this case actually a Module) with code samples, etc., but I'm having trouble getting various tags to work.

''' <summary>
''' Here's a summary of <c>SmallCodeChunk</c>
''' </summary>
''' <example>
'''   Mmm, Skynet?
'''   <code>
'''      code.CodingItself("that's so meta!")
'''   </code>
''' </example>
''' <remarks>
'''   <para>Unit testable by replacing the <see cref="Implementation"/> property 
'''         with a mocked/stubbed <see cref="IThingy"/>.
'''   </para>
'''   <para>Paragraph of a bunch of stuff. <c>Y</c> is used for <c>True</c> just
'''         for the sake of making the universe a (not) better place.
'''   </para>
''' </remarks>

I realize that some of the tags used (like <exception>) probably aren't really valid, but it seems like I should be able to do things like <example>. And I'd expect some sort of formatting (monospace font maybe?) for <c> tags.

If I'm not doing anything wrong, is there a subset of XML doc tags that are supported for display in the Object Browser?

like image 550
Jeff B Avatar asked Jun 05 '13 19:06

Jeff B


2 Answers

According to a 2009 article in MSDN Magazine:

Object Browser displays summary, param, return, remarks, typeparam, and exception comments when they exist.

A 2006 post on the MSDN Blogs adds see and seealso to that list.

like image 115
Richard Deeming Avatar answered Oct 19 '22 23:10

Richard Deeming


Here is a list of the "recommended" tags to use: http://msdn.microsoft.com/en-us/library/ms172653(v=vs.80).aspx

In short they are:

<c>
<code>
<example>
<exception> *
<include> *
<list>
<para>
<param> *
<paramref>
<permission> *
<remarks>
<returns>
<see> *
<seealso> *
<summary>
<typeparam> *
<value>

where '*' denotes tags for which the compiler verifies syntax. And here is a short article with some additional how to's and examples:

http://msdn.microsoft.com/en-us/magazine/dd722812.aspx

like image 31
Gojira Avatar answered Oct 20 '22 00:10

Gojira