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

[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

 

[Erik Frey]

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

or <see also>.

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

Regards,
Tom

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

http://ndoc.sourceforge.net/wiki

Erik

 

[Tom Vogel]

This is really an excellent tool. Thanks for the help.

Tom