Fog Creek Software
Discussion Board




documentation generation from type library

Does anyone know of any good tools to generate docs from a TLB or IDL? should be pretty simple to generate rough a outline, or even a visio file. it would then be cleaned up by hand to hook things together (e.g. get_Foo returns IDispatch, but you know it's really a Foo object) and add more information (Navigate(bstr) really takes a URL).

i haven't found anything other than ActiveXExplorer, which looks like overkill.

mb
Thursday, January 22, 2004

The only thing that I know of that is even closely related is the HTML Help COM Assistant from Dev Components (free):

http://www.devcomponents.com/comassistant/

I know that it does DLL or OCX files, I'm not sure about TLB or IDL files.

Wayne
Friday, January 23, 2004

I don't know of a pre-built one, but OLEAut32.dll has a pretty good COM API for loading COM typelibs/dlls/exes and getting info from them - it should be pretty easy to use that to build your own.  (I assume that it's what the VB object browser uses).  Take a look here: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/automat/htm/chap9_1axu.asp for details.

R1ch
Friday, January 23, 2004

I have used a product called help builder which produced a chm help file amongst other things. Seemed to work well for this purpose but not as a general help file builder.

Tony Edgecombe
Friday, January 23, 2004

Innovasys make a product called Document X.

Its quite good. I used it a year or so ago for something.

http://www.innovasys.co.uk

[Embarrasingly, their website has just been stuffed by someone - seems to work ok, it just looks a mess at the moment. What does "Schadenfreude" mean? ;)  ]

Justin
Friday, January 23, 2004

thanks, we'll take a look at these tools. it's for our own code, but the TLB (or IDL--they can be generated from eachother) isn't really 'documentation' of a useful sort, but should be deterministcally translatable into something useful with a small push from a person.

mb
Monday, January 26, 2004

*  Recent Topics

*  Fog Creek Home