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

[Lee Mallabone]

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'.

Great, that makes things easier.

> > 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.

Okay, but in this case it's very confusing - a user should never call
Entry.StartEditing() should they? I've never encountered it using
'normal' gtk+.

I'm not sure what that even means - IIRC a lot of those "virtual"
declarations are along a similar theme, which is I think what confused
me in the first place.

Regards,

Lee.