generating dev documentation from standard commenting.


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
 
Ad

Advertisements

D

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
 
P

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.
 
H

Herfried K. Wagner [MVP]

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

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

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?
 
Ad

Advertisements

H

Herfried K. Wagner [MVP]

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?

Maybe...
 
Ad

Advertisements


Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Top