diff --git a/ChangeLog b/ChangeLog index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-0 b/ChangeLog.pre-2-0 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-0 +++ b/ChangeLog.pre-2-0 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 3075f9b8d0..c742455edb 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,7 @@ +Wed Mar 28 21:12:37 2001 Tim Janik + + * gtk/gtkwidget.h: c++ fixes. + Sun Mar 25 15:51:28 2001 Owen Taylor * gtk/gtksettings.c (gtk_settings_init): Fix use of uninitialized diff --git a/docs/reference/gtk/tmpl/gtksignal.sgml b/docs/reference/gtk/tmpl/gtksignal.sgml index 1bb805c8ba..1a5a4f3e27 100644 --- a/docs/reference/gtk/tmpl/gtksignal.sgml +++ b/docs/reference/gtk/tmpl/gtksignal.sgml @@ -289,7 +289,7 @@ you don't want a return value. the callbacks. - + Given the name of the signal and the type of object it connects to, get the signal's identifying integer. Emitting the signal @@ -299,13 +299,12 @@ by number is somewhat faster than using the name each time. It also tries the ancestors of the given type. -@Returns: the signal's identifying number, or 0 if no signal was found. - @name: the signal's name, e.g. clicked. @object_type: the type that the signal operates on, e.g. #GTK_TYPE_BUTTON. +@Returns: the signal's identifying number, or 0 if no signal was found. - + Given the signal's identifier, find its name. @@ -313,9 +312,8 @@ Given the signal's identifier, find its name. Two different signals may have the same name, if they have differing types. -@Returns: the signal name, or NULL if the signal number was invalid. - @signal_id: the signal's identifying number. +@Returns: the signal name, or NULL if the signal number was invalid. @@ -383,7 +381,7 @@ an array of GtkArgs instead of using C's varargs mechanism. followed by one which is a pointer to the return type. - + This function aborts a signal's current emission. @@ -397,11 +395,11 @@ It will print a warning if used on a signal which isn't being emitted. -@i: -@s: - @object: the object whose signal handlers you wish to stop. @signal_id: the signal identifier, as returned by gtk_signal_lookup(). + +@i: +@s: @@ -417,7 +415,7 @@ except it will lookup the signal id for you. @name: the name of the signal you wish to stop. - + Attach a function pointer and user data to a signal for a particular object. @@ -456,38 +454,38 @@ static void attach_print_signal(GtkButton* button, gint to_print) -@o: -@s: -@f: -@d: -@Returns: the connection id. - @object: the object associated with the signal, e.g. if a button is getting pressed, this is that button. @name: name of the signal. @func: function pointer to attach to the signal. @func_data: value to pass as to your function (through the marshaller). +@Returns: the connection id. + +@o: +@s: +@f: +@d: - + Attach a function pointer and user data to a signal so that this handler will be called after the other handlers. -@o: -@s: -@f: -@d: -@Returns: the unique identifier for this attachment: the connection id. - @object: the object associated with the signal. @name: name of the signal. @func: function pointer to attach to the signal. @func_data: value to pass as to your function (through the marshaller). +@Returns: the unique identifier for this attachment: the connection id. + +@o: +@s: +@f: +@d: - + This function is for registering a callback that will call another object's callback. That is, @@ -508,21 +506,21 @@ gtk_signal_connect_object(button, "clicked", gtk_widget_show, window); -@o: -@s: -@f: -@d: -@Returns: the connection id. - @object: the object which emits the signal. @name: the name of the signal. @func: the function to callback. @slot_object: the object to pass as the first parameter to func. (Though it pretends to take an object, you can really pass any gpointer as the #slot_object .) +@Returns: the connection id. + +@o: +@s: +@f: +@d: - + Attach a signal hook to a signal, passing in an alternate object as the first parameter, and guaranteeing @@ -530,16 +528,16 @@ that the default handler and all normal handlers are called first. -@o: -@s: -@f: -@d: -@Returns: the connection id. - @object: the object associated with the signal. @name: name of the signal. @func: function pointer to attach to the signal. @slot_object: the object to pass as the first parameter to #func. +@Returns: the connection id. + +@o: +@s: +@f: +@d: @@ -628,98 +626,95 @@ should signal the removal of this signal. @name: name of the signal. - + Destroy a user-defined handler connection. - @object: the object which the handler pertains to. @handler_id: the connection id. - + Destroy all connections for a particular object, with the given function-pointer and user-data. -@o: -@f: -@d: - @object: the object which emits the signal. @func: the function pointer to search for. @data: the user data to search for. + +@o: +@f: +@d: - + Destroy all connections for a particular object, with the given user-data. -@o: -@d: - @object: the object which emits the signal. @data: the user data to search for. + +@o: +@d: - + Prevent an user-defined handler from being invoked. All other signal processing will go on as normal, but this particular handler will ignore it. - @object: the object which emits the signal to block. @handler_id: the connection id. - + Prevent a user-defined handler from being invoked, by reference to the user-defined handler's function pointer and user data. (It may result in multiple hooks being blocked, if you've called connect multiple times.) -@o: -@f: -@d: - @object: the object which emits the signal to block. @func: the function pointer of the handler to block. @data: the user data of the handler to block. + +@o: +@f: +@d: - + Prevent all user-defined handlers with a certain user data from being invoked. -@o: -@d: - @object: the object which emits the signal we want to block. @data: the user data of the handlers to block. + +@o: +@d: - + Undo a block, by connection id. Note that undoing a block doesn't necessarily make the hook callable, because if you block a hook twice, you must unblock it twice. - @object: the object which emits the signal we want to unblock. @handler_id: the emission handler identifier, as returned by gtk_signal_connect(), etc. - + Undo a block, by function pointer and data. Note that undoing a block doesn't @@ -727,29 +722,29 @@ necessarily make the hook callable, because if you block a hook twice, you must unblock it twice. -@o: -@f: -@d: - @object: the object which emits the signal we want to unblock. @func: the function pointer to search for. @data: the user data to search for. + +@o: +@f: +@d: - + Undo block(s), to all signals for a particular object with a particular user-data pointer -@o: -@d: - @object: the object which emits the signal we want to unblock. @data: the user data to search for. + +@o: +@d: - + Returns a connection id corresponding to a given signal id and object. @@ -760,36 +755,36 @@ may opt to not emit the signal if no one is attached anyway, thus saving the cost of building the arguments. -@i: -@s: -@b: -@Returns: the connection id, if a connection was found. 0 otherwise. - @object: the object to search for the desired user-defined handler. @signal_id: the number of the signal to search for. @may_be_blocked: whether it is acceptable to return a blocked handler. +@Returns: the connection id, if a connection was found. 0 otherwise. + +@i: +@s: +@b: - + Returns a connection id corresponding to a given signal id, object, function pointer and user data. -@o: -@s: -@b: -@f: -@d: -@Returns: the connection id, if a handler was found. 0 otherwise. - @object: the object to search for the desired handler. @signal_id: the number of the signal to search for. @may_be_blocked: whether it is acceptable to return a blocked handler. @func: the function pointer to search for. @data: the user data to search for. +@Returns: the connection id, if a handler was found. 0 otherwise. + +@o: +@s: +@b: +@f: +@d: diff --git a/docs/reference/gtk/tmpl/gtktypeutils.sgml b/docs/reference/gtk/tmpl/gtktypeutils.sgml index 16a7e543fe..6295e2dfa1 100644 --- a/docs/reference/gtk/tmpl/gtktypeutils.sgml +++ b/docs/reference/gtk/tmpl/gtktypeutils.sgml @@ -560,33 +560,30 @@ Create a new, unique type. @type_info: must not be null, and @type_info->type_name must also not be null. - + -@Returns: a pointer to the name of a type, or NULL if it has none. - @type: a GtkType +@Returns: a pointer to the name of a type, or NULL if it has none. - + Get the internal representation of a type given its name. -@Returns: a GtkType - @name: the name of a gtk type +@Returns: a GtkType - + -@Returns: the GtkType of the parent - @type: a GtkType +@Returns: the GtkType of the parent @@ -611,16 +608,15 @@ has all the proper initializers called. @Returns: gpointer to a GtkTypeObject - + Look in the type hierarchy to see if @type has @is_a_type among its ancestors. Do so with a simple lookup, not a loop. -@Returns: - @type: GtkType @is_a_type: GtkType +@Returns: diff --git a/gtk/gtkwidget.h b/gtk/gtkwidget.h index b6a8032ff6..3343045d24 100644 --- a/gtk/gtkwidget.h +++ b/gtk/gtkwidget.h @@ -615,9 +615,9 @@ void gtk_widget_pop_colormap (void); /* widget style properties */ -void gtk_widget_class_install_style_property (GtkWidgetClass *class, +void gtk_widget_class_install_style_property (GtkWidgetClass *klass, GParamSpec *pspec); -void gtk_widget_class_install_style_property_parser (GtkWidgetClass *class, +void gtk_widget_class_install_style_property_parser (GtkWidgetClass *klass, GParamSpec *pspec, GtkRcPropertyParser parser); void gtk_widget_style_get_property (GtkWidget *widget,