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).
The only thing that I know of that is even closely related is the HTML Help COM Assistant from Dev Components (free):
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.
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.
Innovasys make a product called Document X.
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.
Fog Creek Home