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 Removed)

Hi,

Yes there is! It is called NDoc.

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

Regards,

Fons

>-----Original Message-----
>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 Removed)
>
>
>.
>

Hi,

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

Thanks for the tip, Ohad


*** Sent via Developersdex http://www.developersdex.com ***
Don't just participate in USENET...get rewarded for it!