Re: [java-gnome-hackers] org.gnu.gtk.Action

[Luca De R. <pie...@li...>]

Il sab, 2003-12-27 alle 13:57, Mark Howard ha scritto:
> Hi, 
>   Documenting these new classes would be *really* useful - especially
> for those of us who have never used the c versions.
> 
> On Sat, Dec 27, 2003 at 01:12:54AM +0100, Luca De Rugeriis wrote:
> > I'm unsure about the constructor; Should it be: 
> > 	public Action(int handle) {
> > 		super(handle);
> 
> This should probably not be public. Methods which take an int handle
> should be used only internally by java-gnome - our users should not need
> to know about handles and other c things (e.g. memory management). In
> some cases, they have to be public (where they are constructed by other
> packages, e.g. pango objects being constructed internally from within
> gtk package. If this is the case, the javadoc must say that this method
> should only be used internally by java-gnome.
Totally agreed.

> This is probably a case of documentation... but where would you get an
> Action object from? 
The GtkAction struct contains only private members and should not be
accessed directly. (from gtk docs)
I think it means private etc. but I don't know how these objects are
created, if I don't understand the C source I can't figure it out well.
There is no action_new method, or something.

I'll integrate documentation in these new classes asap.
		
-- 
Luca De Rugeriis <pie...@li...>