[Gtk-sharp-list] Ugliest docs known to man

Mike Kestner mkestner@speakeasy.net
Mon, 24 Jun 2002 08:15:59 -0700 (PDT)


On Mon, 24 Jun 2002, Jason Diamond wrote:

> MK> I tried NDoc with the Gtk# dll's and am getting reflection errors
> MK> starting with the pango assembly.  When I try to build just the glib
> MK> docs, I get a failure because it's trying to create an MS help file of
> MK> some sort, which I don't even want.  I'd rather just have a set of HTML
> MK> files to distribute/post on the website.
> 
> There's a property that you can set to not compile to HTML Help. But
> even without it, the HTML gets generated before it tries to compile so
> all of your HTML should be there.

I installed the "web setup release" and unless I'm daft (entirely likely), 
I didn't see an option to just build HTML.  Maybe that's in the CVS version?
Anyway, the HTML definitely was not in the output directory that I specified.
Is it built in temp space somewhere?

> Is pango a .NET assembly? If not, NDoc shouldn't be told to document
> it. I'll do a fresh checkout tonight after work to see if I can spot
> what might be wrong.

Yes, specifically, it's pango-sharp.dll, and the corresponding extracted
doc file is pango-sharp-docs.xml.  I appreciate you taking a look. There are
assemblies and doc files built in the glib, pango, atk, gdk, and gtk dirs
of the gtk-sharp tree, and several of them produce Reflection failures
in NDoc. 

Mike