From e2afe00eb1c457ff76770c5d0fd38244c024025b Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 2 Dec 2002 23:48:52 +0000 Subject: [PATCH] Add docs. --- gobject/ChangeLog | 6 ++++++ gobject/gtype.c | 29 +++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) diff --git a/gobject/ChangeLog b/gobject/ChangeLog index a6e02b9..5d60344 100644 --- a/gobject/ChangeLog +++ b/gobject/ChangeLog @@ -1,3 +1,9 @@ +2002-12-03 Matthias Clasen + + * gtype.c (g_type_get_qdata): + (g_type_set_qdata): + (g_type_interface_add_prerequisite): Add docs. + 2002-12-02 Matthias Clasen * gobject.c (g_signal_connect_object): Add docs. diff --git a/gobject/gtype.c b/gobject/gtype.c index 69f1f97..95dc03b 100644 --- a/gobject/gtype.c +++ b/gobject/gtype.c @@ -1146,6 +1146,17 @@ type_iface_add_prerequisite_W (TypeNode *iface, type_iface_add_prerequisite_W (lookup_type_node_I (dependants[i]), prerequisite_node); } +/** + * g_type_interface_add_prerequisite: + * @interface_type: #GType value of an interface type. + * @prerequisite_type: #GType value of an interface or instantiatable type. + * + * Adds @prerequisite_type to the list of prerequisites of @interface_type. + * This means that any type implementing @interface_type must also implement + * @prerequisite_type. Prerequisites can be thought of as an alternative to + * interface derivation (which GType doesn't support). An interface can have + * at most one instantiatable prerequisite type. + **/ void g_type_interface_add_prerequisite (GType interface_type, GType prerequisite_type) @@ -2428,6 +2439,16 @@ type_get_qdata_L (TypeNode *node, return NULL; } +/** + * g_type_get_qdata: + * @type: a #GType + * @quark: a #GQuark id to identify the data + * + * Obtains data which has previously been attached to @type + * with g_type_set_qdata(). + * + * Return value: the data, or %NULL if no data was found + **/ gpointer g_type_get_qdata (GType type, GQuark quark) @@ -2485,6 +2506,14 @@ type_set_qdata_W (TypeNode *node, qdata[i].data = data; } +/** + * g_type_set_qdata: + * @type: a #GType + * @quark: a #GQuark id to identify the data + * @data: the data + * + * Attaches arbitrary data to a type. + **/ void g_type_set_qdata (GType type, GQuark quark, -- 2.7.4