destruction cleanup. there's one ->finalize_hook member in the hooklist

Thu Mar  8 16:23:34 2001  Tim Janik  <timj@gtk.org>

        * ghook.[hc]: destruction cleanup. there's one
        ->finalize_hook member in the hooklist now that gets
        called when a hook should be destroyed, that's it.
        that function is guarranteed to be called only when
        all ref_counts to the hook vanished, thus also when
        the hook is not in call.

Thu Mar  8 16:35:48 2001  Tim Janik  <timj@gtk.org>

        * gparamspecs.[hc]: s/g_param_spec_string_c/g_param_spec_stringc/.

        * gsignal.[hc]: fixed accumulator invocation, implemented emission
        hooks. and no, neither of these callbacks are called via a closure,
        language bindings can wrap the accumulator and emission hook
        interface, they already get parameters marshalled into a GValue array.
        (g_signal_connect): removed this function as its C specific, doesn't
        cover the swapped argument, is too close to its broken original
        gtk_signal_connect() and creates demand for _swapped, _after and
        _swapped_after variants <brrr>.
        (g_signal_connectc): convenience macro to connect a C handler
        func with data, like the old g_signal_connect() plus swapped
        argument.

        * gtype.h:
        * gboxed.c: added G_TYPE_VALUE boxed type.

docs/reference/glib/tmpl/glib-unused.sgml

@@ -17,6 +17,20 @@
 @s2: 
 @Returns: 
 
+<!-- ##### USER_FUNCTION GHookFreeFunc ##### -->
+<para>
+
+</para>
+
+@hook_list: 
+@hook: 
+
+<!-- ##### MACRO G_HOOK_DEFERRED_DESTROY ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO access ##### -->
 <para>
 

docs/reference/glib/tmpl/hooks.sgml

@@ -68,8 +68,7 @@ and the list of hook functions can be invoked.
 @is_setup: 
 @hooks: 
 @hook_memchunk: 
-@hook_free: 
-@hook_destroy: 
+@finalize_hook: 
 
 <!-- ##### STRUCT GHook ##### -->
 <para>
@@ -153,6 +152,8 @@ and the list of hook functions can be invoked.
 </para>
 
 @hook: 
+@marshal_data: 
+<!-- # Unused Parameters # -->
 @data: 
 
 
@@ -162,24 +163,10 @@ and the list of hook functions can be invoked.
 </para>
 
 @hook: 
-@data: 
+@marshal_data: 
 @Returns: 
-
-
-<!-- ##### USER_FUNCTION GHookFreeFunc ##### -->
-<para>
-
-</para>
-
-@hook_list: 
-@hook: 
-
-
-<!-- ##### MACRO G_HOOK_DEFERRED_DESTROY ##### -->
-<para>
-
-</para>
-
+<!-- # Unused Parameters # -->
+@data: 
 
 
 <!-- ##### FUNCTION g_hook_list_init ##### -->
@@ -222,6 +209,8 @@ thread) can be called. If set to FALSE, these are skipped.
 @hook_list: a #GHookList.
 @may_recurse: 
 @marshaller: 
+@marshal_data: 
+<!-- # Unused Parameters # -->
 @data: 
 
 
@@ -233,6 +222,8 @@ thread) can be called. If set to FALSE, these are skipped.
 @hook_list: a #GHookList.
 @may_recurse: 
 @marshaller: 
+@marshal_data: 
+<!-- # Unused Parameters # -->
 @data: 
 
 

docs/reference/glib/tmpl/macros_misc.sgml

@@ -66,6 +66,7 @@ only one statement is expected by the compiler.
 Portable way to copy <type>va_list</type> variables.
 </para>
 
+<!-- # Unused Parameters # -->
 @ap1: the <type>va_list</type> variable to place a copy of @ap2 in.
 @ap2: a <type>va_list</type>.
 

docs/reference/gobject/tmpl/gobject-unused.sgml

@@ -1,3 +1,24 @@
+<!-- ##### FUNCTION g_param_spec_string_c ##### -->
+<para>
+
+</para>
+
+@name: 
+@nick: 
+@blurb: 
+@default_value: 
+@flags: 
+@Returns: 
+
+<!-- ##### FUNCTION g_signal_add_emission_hook_full ##### -->
+<para>
+
+</para>
+
+@signal_id: 
+@closure: 
+@Returns: 
+
 <!-- ##### FUNCTION g_type_value_is_a ##### -->
 <para>
 Determines if @value is a #GValue whose type conforms to @type.

docs/reference/gobject/tmpl/signals.sgml

@@ -96,10 +96,13 @@ value returned by the last callback.
 @ihint: 	Signal invokation hint, see #GSignalInvocationHint.
 @return_accu: 	Accumulator to collect callback return values in, this
 		is the return value of the current signal emission.
-@return_value: 	The return value of the most recent callback function.
+@handler_return: 
+@data: 
 @Returns: 	The accumulator function returns whether the signal emission
 		should be aborted. Returning %FALSE means to abort the
 		current emission and %TRUE is returned for continuation.
+<!-- # Unused Parameters # -->
+@return_value: 	The return value of the most recent callback function.
 
 
 <!-- ##### TYPEDEF GSignalCMarshaller ##### -->
@@ -120,6 +123,7 @@ signal system.
 @ihint: 
 @n_param_values: 
 @param_values: 
+@data: 
 @Returns: 
 <!-- # Unused Parameters # -->
 @signal_id: 
@@ -213,6 +217,7 @@ filled in by the g_signal_query() function.
 @signal_flags: 
 @class_offset: 
 @accumulator: 
+@accu_data: 
 @c_marshaller: 
 @return_type: 
 @n_params: 
@@ -230,6 +235,7 @@ filled in by the g_signal_query() function.
 @signal_flags: 
 @class_closure: 
 @accumulator: 
+@accu_data: 
 @c_marshaller: 
 @return_type: 
 @n_params: 
@@ -247,6 +253,7 @@ filled in by the g_signal_query() function.
 @signal_flags: 
 @class_closure: 
 @accumulator: 
+@accu_data: 
 @c_marshaller: 
 @return_type: 
 @n_params: 
@@ -563,16 +570,6 @@ otherwise.
 @detail: 
 
 
-<!-- ##### FUNCTION g_signal_add_emission_hook_full ##### -->
-<para>
-
-</para>
-
-@signal_id: 
-@closure: 
-@Returns: 
-
-
 <!-- ##### FUNCTION g_signal_remove_emission_hook ##### -->
 <para>
 

docs/reference/gobject/tmpl/standard_params.sgml

@@ -593,19 +593,6 @@ Standard Parameter Types
 @Returns: 
 
 
-<!-- ##### FUNCTION g_param_spec_string_c ##### -->
-<para>
-
-</para>
-
-@name: 
-@nick: 
-@blurb: 
-@default_value: 
-@flags: 
-@Returns: 
-
-
 <!-- ##### FUNCTION g_param_spec_boxed ##### -->
 <para>
 

docs/reference/gobject/tmpl/types.sgml

@@ -201,6 +201,7 @@ The predefined identifiers of the reserved fundamental types.
 @G_TYPE_RESERVED_BSE_LAST: 	Last fundamental type ID reserved for BSE.
 @G_TYPE_RESERVED_LAST_FUNDAMENTAL: Last reserved fundamental type ID.
 @G_TYPE_CLOSURE: 
+@G_TYPE_VALUE: 
 @G_TYPE_VALUE_ARRAY: 
 @G_TYPE_PARAM_CHAR: 		Identifier for the "#GParamSpecChar" type.
 @G_TYPE_PARAM_UCHAR: 		Identifier for the "#GParamSpecUChar" type.