Any documentation authoring tools for VB.Net 2.0 nonASP.Net Projects | Tech Off

bob53050

Any good alternatives for generating documentation from VB.Net 2.0 files (nonASP.Net) projects?

Thanks in advance Smiley

Bob Hanson

W3bbo
The Master of Baiters

NDoc, there's an add-on so it works with VBC.

bob53050

W3bbo wrote:
NDoc, there's an add-on so it works with VBC.

Based on what I am seeing on that website, it doesn't currently support VB.Net 2.0 Sad

Sven Groot
My name has 9 letters. Coincidence? I think not...

There is currently no free tool that I know of that will generate decent documentation files for .Net 2.0.

I'm working on something myself, but I'm very busy so probably by the time that gets anywhere NDoc will probably support it too. Wink

W3bbo
The Master of Baiters

bob53050 wrote:
W3bbo wrote:NDoc, there's an add-on so it works with VBC.

Based on what I am seeing on that website, it doesn't currently support VB.Net 2.0

IIRC, NDoc only takes in the %assemblyName%.xml files. So the language version means nothing since AFAIK VBC8 generates the XML files that meet the same schema as CSC1.x

Sven Groot
My name has 9 letters. Coincidence? I think not...

W3bbo wrote:

bob53050 wrote:

W3bbo wrote: NDoc, there's an add-on so it works with VBC.

Based on what I am seeing on that website, it doesn't currently support VB.Net 2.0

IIRC, NDoc only takes in the %assemblyName%.xml files. So the language version means nothing since AFAIK VBC8 generates the XML files that meet the same schema as CSC1.x

It also needs the assembly itself to determine what classes/methods are public and protected so would need to be included. But as indicated by Gregory, Generics are the real issue.

gregoryw

bob53050 wrote:
W3bbo wrote:NDoc, there's an add-on so it works with VBC.

Based on what I am seeing on that website, it doesn't currently support VB.Net 2.0

The last I knew there is a version that supports .net 2.0 with a couple of exceptions:

You can't document anything to do with generics yet.
The links to BCL classes in the documentation are broken.

From recent ndoc-users mailing list discussions there appear to be several forked builds that fix these issues.

Oh, and if you take a look at the NDoc website then be warned that the Wiki about .net 2.0 support has been broken for months.

EDIT: You can get the NDoc Wiki entry about .net 2.0 support from Google's cache:
http://66.249.93.104/search?q=cache:LmKSsFUd680J:ndoc.sourceforge.net/wiki/dotNet_2.0_Support+&hl=en&ct=clnk&cd=1&client=firefox-a

Also, see:

http://jonas.lagerblad.com/blog/?p=5

which is a blog entry made by somebody that's been working on one of the forks I mentioned above.