[Mono-docs-list] Re: [Gtk-sharp-list] Documentation effort: Documenting Gtk#

[Miguel de Icaza]

Hello!

> In doc/en/Entry.xml, there is a public constructor on line 277 that
> takes a raw IntPtr. I would have thought the details of it should be
> hidden?

Ah!  This is correct.  Just document that as `Internal constructor'.

> There are lots of virtual methods in that same xml file (from line 59)
> that do not appear in my generated Entry.cs file. Should they be
> documented?

StartEditing becomes "virtual" because it is an implementation of an
interface method.  So even if the virtual keyword does not appear on the
source, it is virtual due to its interface implementation nature.

> If the above happens, I would hope that the priority and usefulness of
> Gst# docs would go up. :)

Heh.  It would be nice to document Gst, but the impact of documenting
this is lower (because fewer people will be using it) that say, a
GtkLabel or a GtkNotebook.

Miguel