diff options
author | Emmanuele Bassi <ebassi@gnome.org> | 2013-08-27 14:11:47 +0200 |
---|---|---|
committer | Martin Pitt <martinpitt@gnome.org> | 2013-09-02 08:25:56 +0200 |
commit | a72983a5db5d25e6face815c6eba5775175e4aa4 (patch) | |
tree | af7431d43a443534d51a2f52615c84c6becd19c1 | |
parent | c81773da9cd21f1122da6e049d111cac8d6b6a3e (diff) | |
download | glib-a72983a5db5d25e6face815c6eba5775175e4aa4.tar.gz |
gobject-2.0: Annotate GSignal functions taking instances
Unbreak the GSignal API at least for GObject sub-classes.
https://bugzilla.gnome.org/show_bug.cgi?id=685387
-rw-r--r-- | gobject/gsignal.c | 38 |
1 files changed, 19 insertions, 19 deletions
diff --git a/gobject/gsignal.c b/gobject/gsignal.c index 951b9c037..903557ec5 100644 --- a/gobject/gsignal.c +++ b/gobject/gsignal.c @@ -864,7 +864,7 @@ _g_signals_destroy (GType itype) /** * g_signal_stop_emission: - * @instance: the object whose signal handlers you wish to stop. + * @instance: (type GObject.Object): the object whose signal handlers you wish to stop. * @signal_id: the signal identifier, as returned by g_signal_lookup(). * @detail: the detail which the signal was emitted with. * @@ -1128,7 +1128,7 @@ g_signal_parse_name (const gchar *detailed_signal, /** * g_signal_stop_emission_by_name: - * @instance: the object whose signal handlers you wish to stop. + * @instance: (type GObject.Object): the object whose signal handlers you wish to stop. * @detailed_signal: a string of the form "signal-name::detail". * * Stops a signal's current emission. @@ -2069,7 +2069,7 @@ g_signal_chain_from_overridden (const GValue *instance_and_params, } /** - * g_signal_chain_from_overridden_handler: + * g_signal_chain_from_overridden_handler: (skip) * @instance: the instance the signal is being emitted on. * @...: parameters to be passed to the parent class closure, followed by a * location for the return value. If the return type of the signal @@ -2233,7 +2233,7 @@ g_signal_chain_from_overridden_handler (gpointer instance, /** * g_signal_get_invocation_hint: - * @instance: the instance to query + * @instance: (type GObject.Object): the instance to query * * Returns the invocation hint of the innermost signal emission of instance. * @@ -2255,7 +2255,7 @@ g_signal_get_invocation_hint (gpointer instance) /** * g_signal_connect_closure_by_id: - * @instance: the instance to connect to. + * @instance: (type GObject.Object): the instance to connect to. * @signal_id: the id of the signal. * @detail: the detail. * @closure: the closure to connect. @@ -2315,7 +2315,7 @@ g_signal_connect_closure_by_id (gpointer instance, /** * g_signal_connect_closure: - * @instance: the instance to connect to. + * @instance: (type GObject.Object): the instance to connect to. * @detailed_signal: a string of the form "signal-name::detail". * @closure: the closure to connect. * @after: whether the handler should be called before or after the @@ -2403,7 +2403,7 @@ node_check_deprecated (const SignalNode *node) /** * g_signal_connect_data: - * @instance: the instance to connect to. + * @instance: (type GObject.Object): the instance to connect to. * @detailed_signal: a string of the form "signal-name::detail". * @c_handler: the #GCallback to connect. * @data: data to pass to @c_handler calls. @@ -2480,7 +2480,7 @@ g_signal_connect_data (gpointer instance, /** * g_signal_handler_block: - * @instance: The instance to block the signal handler of. + * @instance: (type GObject.Object): The instance to block the signal handler of. * @handler_id: Handler id of the handler to be blocked. * * Blocks a handler of an instance so it will not be called during any @@ -2518,7 +2518,7 @@ g_signal_handler_block (gpointer instance, /** * g_signal_handler_unblock: - * @instance: The instance to unblock the signal handler of. + * @instance: (type GObject.Object): The instance to unblock the signal handler of. * @handler_id: Handler id of the handler to be unblocked. * * Undoes the effect of a previous g_signal_handler_block() call. A @@ -2560,7 +2560,7 @@ g_signal_handler_unblock (gpointer instance, /** * g_signal_handler_disconnect: - * @instance: The instance to remove the signal handler from. + * @instance: (type GObject.Object): The instance to remove the signal handler from. * @handler_id: Handler id of the handler to be disconnected. * * Disconnects a handler from an instance so it will not be called during @@ -2596,7 +2596,7 @@ g_signal_handler_disconnect (gpointer instance, /** * g_signal_handler_is_connected: - * @instance: The instance where a signal handler is sought. + * @instance: (type GObject.Object): The instance where a signal handler is sought. * @handler_id: the handler id. * * Returns whether @handler_id is the id of a handler connected to @instance. @@ -2665,7 +2665,7 @@ g_signal_handlers_destroy (gpointer instance) /** * g_signal_handler_find: - * @instance: The instance owning the signal handler to be found. + * @instance: (type GObject.Object): The instance owning the signal handler to be found. * @mask: Mask indicating which of @signal_id, @detail, @closure, @func * and/or @data the handler has to match. * @signal_id: Signal the handler has to be connected to. @@ -2745,7 +2745,7 @@ signal_handlers_foreach_matched_R (gpointer instance, /** * g_signal_handlers_block_matched: - * @instance: The instance to block handlers from. + * @instance: (type GObject.Object): The instance to block handlers from. * @mask: Mask indicating which of @signal_id, @detail, @closure, @func * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. @@ -2792,7 +2792,7 @@ g_signal_handlers_block_matched (gpointer instance, /** * g_signal_handlers_unblock_matched: - * @instance: The instance to unblock handlers from. + * @instance: (type GObject.Object): The instance to unblock handlers from. * @mask: Mask indicating which of @signal_id, @detail, @closure, @func * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. @@ -2840,7 +2840,7 @@ g_signal_handlers_unblock_matched (gpointer instance, /** * g_signal_handlers_disconnect_matched: - * @instance: The instance to remove handlers from. + * @instance: (type GObject.Object): The instance to remove handlers from. * @mask: Mask indicating which of @signal_id, @detail, @closure, @func * and/or @data the handlers have to match. * @signal_id: Signal the handlers have to be connected to. @@ -2888,7 +2888,7 @@ g_signal_handlers_disconnect_matched (gpointer instance, /** * g_signal_has_handler_pending: - * @instance: the object whose signal handlers are sought. + * @instance: (type GObject.Object): the object whose signal handlers are sought. * @signal_id: the signal id. * @detail: the detail. * @may_be_blocked: whether blocked handlers should count as match. @@ -3077,7 +3077,7 @@ accumulate (GSignalInvocationHint *ihint, } /** - * g_signal_emit_valist: + * g_signal_emit_valist: (skip) * @instance: the instance the signal is being emitted on. * @signal_id: the signal id * @detail: the detail @@ -3358,7 +3358,7 @@ g_signal_emit_valist (gpointer instance, /** * g_signal_emit: - * @instance: the instance the signal is being emitted on. + * @instance: (type GObject.Object): the instance the signal is being emitted on. * @signal_id: the signal id * @detail: the detail * @...: parameters to be passed to the signal, followed by a @@ -3385,7 +3385,7 @@ g_signal_emit (gpointer instance, /** * g_signal_emit_by_name: - * @instance: the instance the signal is being emitted on. + * @instance: (type GObject.Object): the instance the signal is being emitted on. * @detailed_signal: a string of the form "signal-name::detail". * @...: parameters to be passed to the signal, followed by a * location for the return value. If the return type of the signal |