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

[Lee Mallabone]

Hello,

> > 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+.
> 
> They do that through interface invocation.  We just happen to make this
> a lot easier than in Gtk ;-)

Right. In that case, is it worth documenting all the implicit interface
implementations? Your explanation implies that they will all be present
in the XML doc skeletons regardless of whether the interface
implementations are *intended* for public use or not...

At the moment I'm thinking that just a note will be good enough, saying
something like "the Entry widget's implementation of
IEditable.StartEditing" or equivalent.

...snip cool .NET implicit interface description...
> The compiler knows that the `SayHello' method in EnglishGreeter is an
> implementation of the interface method IHello.SayHello (this is called
> an implicit interface implementation).  Notice that implicit interface
> implementations have to be public.

Aha. I should have figured that out! Thanks for the good explanation of
.NET interface implementing. My background is in C/Java, so it's good to
know the internals better.

Cheers,

Lee.