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

Mike Kestner mkestner@speakeasy.net
24 Jun 2002 09:31:09 -0500

On Sun, 2002-06-23 at 17:42, Rachel Hestilow wrote:
> I've gotten some docs up at
> http://primates.ximian.com/~tvgm/gtk-sharp-docs/ , along with the
> scripts used to generate them. Currently I use a two-stage process: a
> perl script to do the heavy lifting (regexes, grouping) and an XSLT
> script to produce the final XHTML. The csc-generated docs purposely
> leave out anything that could be otherwise looked up via introspection,
> so because of this the docs currently lack return types, property types,
> inheritance lists etc. Support for this could be implemented by adding a
> .NET introspection stage inbetween the perl and XSLT, most likely
> written in C#.

So, I've been thinking about this some more.  The introspection stuff is
no doubt what the good folks at NDoc are doing.  I'm copying Jason on
this, because I recall him being involved in NDoc.  

I tried NDoc with the Gtk# dll's and am getting reflection errors
starting with the pango assembly.  When I try to build just the glib
docs, I get a failure because it's trying to create an MS help file of
some sort, which I don't even want.  I'd rather just have a set of HTML
files to distribute/post on the website.

So Jason, or anyone else in the know on NDoc, any chance of getting some
love on the above issues?  If you want to look at the pango ndoc
failure, you can build gtk-sharp with the /doc switch with the command
"make -f makefile.win32 docs" on win32.