generating dev documentation from standard commenting.

[Miraj Haq]

Hi,

I was amazed to see the new feature of "Insert Comment" on right click
context menu over a sub routine or a class in vb.net.

I can see using standard commenting mechanism, i can see help in
intellisense and object browser. I am looking for ways to generate
documentation (chm, or latest formats)
from
-----------------------------
"
''' <summary>
''' Used to handle custom requests
''' </summary>

''' <remarks>The class CustomHandler is designed to handle custom http
requests, you can do blah blah in order to achieve something</remarks>
Public Class CustomHandler
Inherits System.Web.DefaultHttpHandler
End Class
------------------------------

and from
------------------------------
''' <summary>
''' Allows direct access to request being received.
''' </summary>
''' <returns>Returns the value</returns>
''' <remarks>Function OverrideExecuteUrlPath allows to override aspnet
handling mechanism</remarks>
Public Overrides Function OverrideExecuteUrlPath() As String
Return "/default.aspx" 'MyBase.OverrideExecuteUrlPath
End Function
--------------------------------

Any ideas, tools, methods available?

Many thanks,
Miraj

 

[dkode]

take a look at NDoc, its on sourceforge. Not sure if they have
framework 2.0 support yet, but it does alot with the xml code comments

 

[Peter Macej]

If you don't mind commercial product, you can try our VBdocman .NET. It
fully supports .NET 2.0 with generics and partial classes.

 

[Herfried K. Wagner [MVP]]

take a look at NDoc, its on sourceforge. Not sure if they have
framework 2.0 support yet, but it does alot with the xml code comments

No, it unfortunately doesn't support .NET 2.0.

 

[Miraj Haq]

Thanks all of you for replies!

So it means, MS VS 2005 editions are presently missing documentation tool?

Its like Microsoft wanted to give its partners the opportunity to build such
tools for users of vs 2005?

 

[Herfried K. Wagner [MVP]]

So it means, MS VS 2005 editions are presently missing documentation tool?
Yes.

Its like Microsoft wanted to give its partners the opportunity to build
such tools for users of vs 2005?

Maybe...