Add g_type_add/remove_interface_check()

Thu Oct  2 01:22:46 2003  Owen Taylor  <otaylor@redhat.com>

        * gobject/gobject-sections.txt gobject/tmpl/gtype.sgml:
        Add g_type_add/remove_interface_check()

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f251e00..0dd55f3 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+Thu Oct  2 01:22:46 2003  Owen Taylor  <otaylor@redhat.com>
+
+       * gobject/gobject-sections.txt gobject/tmpl/gtype.sgml: 
+       Add g_type_add/remove_interface_check()
+

 2003-09-30  Matthias Clasen  <maclas@gmx.de>
 
        * gobject/tmpl/gparamspec.sgml: 
 2003-09-30  Matthias Clasen  <maclas@gmx.de>
 
        * gobject/tmpl/gparamspec.sgml: 

diff --git a/docs/reference/gobject/gobject-sections.txt b/docs/reference/gobject/gobject-sections.txt
index 9c6d0d7..32c2220 100644 (file)
--- a/docs/reference/gobject/gobject-sections.txt
+++ b/docs/reference/gobject/gobject-sections.txt
@@ -91,6 +91,9 @@ g_type_free_instance
 g_type_add_class_cache_func
 g_type_remove_class_cache_func
 g_type_class_unref_uncached
 g_type_add_class_cache_func
 g_type_remove_class_cache_func
 g_type_class_unref_uncached

+g_type_add_interface_check
+g_type_remove_interface_check
+GTypeInterfaceCheckFunc

 g_type_value_table_peek
 <SUBSECTION Private>
 G_TYPE_FUNDAMENTAL_SHIFT
 g_type_value_table_peek
 <SUBSECTION Private>
 G_TYPE_FUNDAMENTAL_SHIFT

diff --git a/docs/reference/gobject/tmpl/gtype.sgml b/docs/reference/gobject/tmpl/gtype.sgml
index ce80e30..f34c833 100644 (file)
--- a/docs/reference/gobject/tmpl/gtype.sgml
+++ b/docs/reference/gobject/tmpl/gtype.sgml
@@ -1321,6 +1321,45 @@ fundamental types.
 @g_class: 
 
 
 @g_class: 
 
 

+<!-- ##### FUNCTION g_type_add_interface_check ##### -->
+<para>
+Adds a function to be called after an interface vtable is
+initialized for any class. That is, after the @interface_init
+member of #GInterfaceInfo has been called.
+</para>
+<para>
+This function is useful when you want to check an invariant
+that depends on the interfaces of a class. For instance,
+the implementation of #GObject uses this facility to check
+that an object implements all of the properties that are
+defined on its interfaces.    
+</para>
+
+@check_data: data to pass to @check_func
+@check_func: function to be called after each interface
+   is initialized.
+
+
+<!-- ##### FUNCTION g_type_remove_interface_check ##### -->
+<para>
+Removes an interface check function added with
+g_type_add_interface_check().
+</para>
+
+@check_data: callback data passed to g_type_add_interface_check()
+@chec_func: callback function passed to g_type_add_interface_check()
+
+
+<!-- ##### USER_FUNCTION GTypeInterfaceCheckFunc ##### -->
+<para>
+A callback called after an interface vtable is initialized.
+See g_type_add_interface_check().
+</para>
+
+@func_data: data passed to g_type_add_interface_check().
+@g_iface: the interface that has been initialized
+
+

 <!-- ##### FUNCTION g_type_value_table_peek ##### -->
 <para>
 Returns the location of the #GTypeValueTable associated with @type.
 <!-- ##### FUNCTION g_type_value_table_peek ##### -->
 <para>
 Returns the location of the #GTypeValueTable associated with @type.