creating code reports

[Ohad Young]

Hi,

I'm trying to document my code written in VS.NET 2003 using C#.
I'm using the Xml documentation following the recommendations found
in MSDN's "Recommended Tags for Documentation Comments".
When generating the comment web pages using the option
"Build comment web pages..." in the Tools menu the result is far from being
satisfactory. Some of the documentation is missing or, for example:
<exception>, <see> and <list> tags are not interpreted.
In addition, the private members (fields, methods, etc.) appears in the
comment web pages and there is no tag to hide them.

How cam I generate a more comprehensive documentation, like JavaDoc, using
VS.NET?
Is there an alternative freeware tool to document my code?

Thanks in advance, Ohad
--
Ohad Young
Medical Informatics Research Center
Ben Gurion University
Information System Eng
Office Phone: 972-8-6477160
Cellular Phone: 972-54-518301
E-Mail: (e-mail address removed)

 

[Fons Sonnemans]

Hi,

Yes there is! It is called NDoc.

Have a look at:
http://ndoc.sf.net/
http://www.reflectionit.nl/NDoc.aspx

Regards,

Fons

 

[Ohad Young]

Hi,

I checked NDoc as you suggested and the results are amazing. Great work
by NDoc developers

Thanks for the tip, Ohad