From ac94781e28fc0036e7ba7302e6816172ea41e326 Mon Sep 17 00:00:00 2001 From: Stefan Kost Date: Sun, 22 Jun 2008 10:10:59 +0000 Subject: [PATCH] Move some content for gobject-unused.sgml and cleared empty entries. The * docs/reference/gobject/tmpl/gobject-unused.sgml: * gobject/gobject.h: * gobject/gtype.c: * gobject/gtype.h: Move some content for gobject-unused.sgml and cleared empty entries. The remaining 4 ones should be checked by some else. If they are not needed. The file can be removed. svn path=/trunk/; revision=7087 --- ChangeLog | 10 + .../gobject/tmpl/gobject-unused.sgml | 290 ------------------ gobject/gobject.h | 36 +++ gobject/gtype.c | 9 + gobject/gtype.h | 5 + 5 files changed, 60 insertions(+), 290 deletions(-) diff --git a/ChangeLog b/ChangeLog index 2cae650ce..ceb74bf5e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,13 @@ +2008-06-22 Stefan Kost + + * docs/reference/gobject/tmpl/gobject-unused.sgml: + * gobject/gobject.h: + * gobject/gtype.c: + * gobject/gtype.h: + Move some content for gobject-unused.sgml and cleared empty entries. + The remaining 4 ones should be checked by some else. If they are not + needed. The file can be removed. + 2008-06-22 Stefan Kost * docs/reference/gobject/tmpl/value_collection.sgml: diff --git a/docs/reference/gobject/tmpl/gobject-unused.sgml b/docs/reference/gobject/tmpl/gobject-unused.sgml index e10d7c939..48f8a2e01 100644 --- a/docs/reference/gobject/tmpl/gobject-unused.sgml +++ b/docs/reference/gobject/tmpl/gobject-unused.sgml @@ -1,43 +1,3 @@ - - - - - - - - - - - - - - - - - -Parameter Specifications - - - - - - - - - - - - - -@Returns: - - - - - - -@parent_instance: - The predefined identifiers of the reserved fundamental types. @@ -94,172 +54,6 @@ The predefined identifiers of the reserved fundamental types. @G_TYPE_PARAM_CLOSURE: @G_TYPE_PARAM_OBJECT: - - -Casts a #GInitiallyUnowned or derived pointer into a (GInitiallyUnowned*) -pointer. Depending on the current debugging level, this function may invoke -certain runtime checks to identify invalid casts. - - -@object: Object which is subject to casting - - - -Casts a derived #GInitiallyUnownedClass structure into a -#GInitiallyUnownedClass structure. - - -@class: a valid #GInitiallyUnownedClass - - - -Returns the class structure associated to a #GInitiallyUnowned instance. - - -@object: a #GInitiallyUnowned instance - - - -Checks whether a valid #GTypeInstance pointer is of type -%G_TYPE_INITIALLY_UNOWNED. - - -@object: Instance to check for being a %G_TYPE_INITIALLY_UNOWNED. - - - -Checks whether @class "is a" valid #GInitiallyUnownedClass structure of type -%G_TYPE_INITIALLY_UNOWNED or derived. - - -@class: a #GInitiallyUnownedClass - - - - - - -@pspec: - - - - - - -@pspec: - - - - - - - - - -Shift value used in converting numbers to type IDs. - - - - - - - - -@closure: -@notify_data: -@notify_func: - - - - - - -@closure: -@notify_data: -@notify_func: - - - - - - -@closure: -@notify_data: -@notify_func: - - - - - - -@closure: -@notify_data: -@notify_func: - - - - - - -@name: -@nick: -@blurb: -@flags: -@Returns: - - - - - - -@name: -@nick: -@blurb: -@default_value: -@flags: -@Returns: - - - - - - -@signal_id: -@closure: -@Returns: - - - - - - -@instance: - - - - - - -@Returns: -@signal_name: -@itype: -@signal_flags: -@class_offset: -@accumulator: -@accu_data: -@c_marshaller: -@return_type: -@n_params: -@Varargs: - - - - - -@g_class: -@is_a_type: -@Returns: - Determines whether a given set of #GTypeFlags and #GTypeFundamentalFlags @@ -270,45 +64,6 @@ are set for @type. @flags: Bitwise combination of #GTypeFlags and #GTypeFundamentalFlags. @Returns: #TRUE if all @flags are set for @type, #FALSE otherwise. - - -Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE() -macro. - - -@instance: A valid #GTypeInstance structure. -@Returns: #TRUE if @instance is valid, #FALSE otherwise. - - - - - -@instance: -@iface_type: -@Returns: - - - - - -@value: -@Returns: - - - - - -@g_class: -@is_a_type: -@Returns: - - - - - - -@Returns: - Determines if @instance adheres to the interface exported @@ -321,15 +76,6 @@ the anchestry of @instance. @iface_type: A #GType value. @Returns: #TRUE if @instance conforms to @iface_type, #FALSE otherwise. - - - - - -@type: -@flags: -@Returns: - Determines if @value is a #GValue whose type conforms to @type. @@ -339,39 +85,3 @@ Determines if @value is a #GValue whose type conforms to @type. @type: A #GType value. @Returns: #TRUE if @value is a #GValue of @type or #FALSE if not. - - - - - -@src_value: -@dest_value: -@Returns: - - - - - - -@value_type1: -@value_type2: -@func: - - - - - - -@value_type1: -@value_type2: -@Returns: - - - - - - -@value1: -@value2: -@Returns: - diff --git a/gobject/gobject.h b/gobject/gobject.h index 5ef57af05..f2653d370 100644 --- a/gobject/gobject.h +++ b/gobject/gobject.h @@ -136,10 +136,46 @@ G_BEGIN_DECLS * The type for #GInitiallyUnowned. */ #define G_TYPE_INITIALLY_UNOWNED (g_initially_unowned_get_type()) +/** + * G_INITIALLY_UNOWNED: + * @object: Object which is subject to casting. + * + * Casts a #GInitiallyUnowned or derived pointer into a (GInitiallyUnowned*) + * pointer. Depending on the current debugging level, this function may invoke + * certain runtime checks to identify invalid casts. + */ #define G_INITIALLY_UNOWNED(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnowned)) +/** + * G_INITIALLY_UNOWNED_CLASS: + * @class: a valid #GInitiallyUnownedClass + * + * Casts a derived #GInitiallyUnownedClass structure into a + * #GInitiallyUnownedClass structure. + */ #define G_INITIALLY_UNOWNED_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass)) +/** + * G_IS_INITIALLY_UNOWNED: + * @object: Instance to check for being a %G_TYPE_INITIALLY_UNOWNED. + * + * Checks whether a valid #GTypeInstance pointer is of type %G_TYPE_INITIALLY_UNOWNED. + */ #define G_IS_INITIALLY_UNOWNED(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_INITIALLY_UNOWNED)) +/** + * G_IS_INITIALLY_UNOWNED_CLASS: + * @class: a #GInitiallyUnownedClass + * + * Checks whether @class "is a" valid #GInitiallyUnownedClass structure of type + * %G_TYPE_INITIALLY_UNOWNED or derived. + */ #define G_IS_INITIALLY_UNOWNED_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_INITIALLY_UNOWNED)) +/** + * G_INITIALLY_UNOWNED_GET_CLASS: + * @object: a #GInitiallyUnowned instance. + * + * Get the class structure associated to a #GInitiallyUnowned instance. + * + * Returns: pointer to object class structure. + */ #define G_INITIALLY_UNOWNED_GET_CLASS(object) (G_TYPE_INSTANCE_GET_CLASS ((object), G_TYPE_INITIALLY_UNOWNED, GInitiallyUnownedClass)) /* GInitiallyUnowned ia a GObject with initially floating reference count */ diff --git a/gobject/gtype.c b/gobject/gtype.c index 203c7fc92..f244829d2 100644 --- a/gobject/gtype.c +++ b/gobject/gtype.c @@ -3750,6 +3750,15 @@ g_type_check_class_cast (GTypeClass *type_class, return type_class; } +/* + * g_type_check_instance: + * @instance: A valid #GTypeInstance structure. + * + * Private helper function to aid implementation of the G_TYPE_CHECK_INSTANCE() + * macro. + * + * @Returns: #TRUE if @instance is valid, #FALSE otherwise. + */ gboolean g_type_check_instance (GTypeInstance *type_instance) { diff --git a/gobject/gtype.h b/gobject/gtype.h index 8ae923a12..1e9a1280a 100644 --- a/gobject/gtype.h +++ b/gobject/gtype.h @@ -185,6 +185,11 @@ G_BEGIN_DECLS * type IDs with G_TYPE_MAKE_FUNDAMENTAL(). * Send email to gtk-devel-list@gnome.org for reservations. */ +/** + * G_TYPE_FUNDAMENTAL_SHIFT: + * + * Shift value used in converting numbers to type IDs. + */ #define G_TYPE_FUNDAMENTAL_SHIFT (2) /** * G_TYPE_MAKE_FUNDAMENTAL: