generating dev documentation from standard commenting.

  • Thread starter Thread starter Miraj Haq
  • Start date Start date
M

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
 
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
 
If you don't mind commercial product, you can try our VBdocman .NET. It
fully supports .NET 2.0 with generics and partial classes.
 
dkode said:
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
Click to expand...

No, it unfortunately doesn't support .NET 2.0.
 
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?
 
Miraj Haq said:
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?
Click to expand...

Maybe...
 
Back
Top