Do XML Documentation Tags like <see>, <seealso>, <list> etc. work?

  • Thread starter Thread starter Tom Vogel
  • Start date Start date
T

Tom Vogel

I'd like to use the XML Documentation Tags to comment my C# code. But many
of the tags do not have any effect when I execute the "Build Comment Web
Pages" menu.

For example, the <list> tag gets reendered as is. The resulting HTML page
contains the exact same tags, which are not valid HTML. The same with <see>
or <see also>.

Isn't this function supposed to transform these tags into valid HTML? Did
anybody see this work properly?

Regards,
Tom
 
Tom Vogel said:
I'd like to use the XML Documentation Tags to comment my C# code. But many
of the tags do not have any effect when I execute the "Build Comment Web
Pages" menu.

For example, the <list> tag gets reendered as is. The resulting HTML page
contains the exact same tags, which are not valid HTML. The same with
Click to expand...
or <see also>.

Isn't this function supposed to transform these tags into valid HTML? Did
anybody see this work properly?

Regards,
Tom
Click to expand...

I use NDoc, and <see> and <seealso> work just as expected.

http://ndoc.sourceforge.net/wiki

Erik
 
Back
Top