Re: GTK+ API fault

[Matthias Clasen <mclasen redhat com>]

On Wed, 2005-09-07 at 18:13 +0200, Kurucz Istvan wrote:
> Hello.
> 
> 
> I would like to ask whether you plan to extend the developer API of the
> GTK, GLib, etc. ?
> Because now it's quite difficult to work on the ground of the following
> example:
> 
> In GtkEntry:
> 
> 
> The "move-cursor" signal
> 
> void        user_function                  (GtkEntry *entry,
>                                             GtkMovementStep arg1,
>                                             gint arg2,
>                                             gboolean arg3,
>                                             gpointer user_data);
> 
> entry : 	the object which received the signal.
> arg1 : 	
> arg2 : 	
> arg3 : 	
> user_data : 	user data set when the signal handler was connected.
> 
> 
> Eg. it isn't mentioned, what the arg1, arg2, arg3 are used for.
> Additionally, it would be great, if every signal are marked with some time
> component (when will it occur).
> And probably to explain in a few words the meaning of Properties and Style
> properties in the widgets.
> It would be great if you could fix these things by the next bugfix release
> because these are more likely the distributions that will use them.
> And it's difficult to work without full API reference.
> 
> I'm sorry for the inconvenience.
> 

Creating complete, uptodate and accurate api documentation for a library
the size of GTK+ is no small task. We are certainly trying to improve
it, but I wouldn't expect us to "fix these things by the next bugfix
release"...

Matthias