100%
authorMatthias Clasen <matthiasc@src.gnome.org>
Fri, 24 Oct 2003 23:10:37 +0000 (23:10 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Fri, 24 Oct 2003 23:10:37 +0000 (23:10 +0000)
docs/reference/ChangeLog
docs/reference/gobject/tmpl/gparamspec.sgml
docs/reference/gobject/tmpl/objects.sgml
gobject/gparam.h

index 35ea803630221519aa6b158940bb9b0feb603a57..d1f8f66fafdd64396d5158e58d158a1c0c49c30c 100644 (file)
@@ -1,3 +1,8 @@
+Sat Oct 25 01:07:45 2003  Matthias Clasen  <maclas@gmx.de>
+
+       * gobject/tmpl/gparamspec.sgml: 
+       * gobject/tmpl/objects.sgml: Additions.
+
 Thu Oct 23 14:27:54 2003  Owen Taylor  <otaylor@redhat.com>
 
        * gobject/Makefile.am: Add a dist-hook so that the
index e6d5a10317a4f10eaf38af7e0c023ec705948d12..84641c8e85cf72f8404c3410fc3e33caf1e8ea2f 100644 (file)
@@ -93,7 +93,8 @@ Retrieves the #GType to initialize a #GValue for this parameter.
 
 <!-- ##### STRUCT GParamSpec ##### -->
 <para>
-
+All fields of the <structname>GParamSpec</structname> struct are private and
+should not be used directly, except for the following:
 </para>
 
 @g_type_instance: private #GTypeInstance portion
@@ -104,16 +105,23 @@ Retrieves the #GType to initialize a #GValue for this parameter.
 
 <!-- ##### STRUCT GParamSpecClass ##### -->
 <para>
-
+The class structure for the <structname>GParamSpec</structname> type.
+Normally, <structname>GParamSpec</structname> classes are filled by
+g_param_type_register_static().
 </para>
 
-@g_type_class: 
-@value_type: 
-@finalize: 
-@value_set_default: 
-@value_validate: 
-@values_cmp: 
-@dummy: 
+@g_type_class: the parent class
+@value_type: the #GValue type for this parameter
+@finalize: The instance finalization function (optional), should chain 
+  up to the finalize method of the parent class.
+@value_set_default: Resets a @value to the default value for this type
+  (recommended, the default is g_value_reset()), see 
+  g_param_value_set_default().
+@value_validate: Ensures that the contents of @value comply with the 
+  specifications set out by this type (optional), see 
+  g_param_value_set_validate().
+@values_cmp: Compares @value1 with @value2 according to this type
+  (recommended, the default is memcmp()), see g_param_values_cmp().
 
 <!-- ##### ENUM GParamFlags ##### -->
 <para>
index 800b9514a5224036f708320db4a074f14815cdb3..083ba009cf9afe09695086708494695562250be6 100644 (file)
@@ -34,17 +34,33 @@ the setter for the property is called to reinstate the previous value.
 
 <!-- ##### STRUCT GObjectClass ##### -->
 <para>
-
-</para>
-
-@g_type_class: 
-@constructor: 
-@set_property: 
-@get_property: 
-@dispose: 
-@finalize: 
-@dispatch_properties_changed: 
-@notify: 
+The class structure for the <structname>GObject</structname> type.
+</para>
+
+@g_type_class: the parent class
+@constructor:  the @constructor function is called by g_object_new () to 
+  complete the object initialization after all the construction properties are
+  set. The first thing a @constructor implementation must do is chain up to the
+  @constructor of the parent class. Overriding @constructor should be rarely 
+  needed.
+@set_property: the generic setter for all properties of this type. Should be
+  overridden for every type with properties. Implementations of @set_property
+  don't need to emit property change notification explicitly, this is handled
+  by the type system.
+@get_property: the generic getter for all properties of this type. Should be
+  overridden for every type with properties.
+@dispose: the @dispose function is supposed to drop all references to other 
+  objects, but keep the instance otherwise intact, so that client method 
+  invocations still work. It may be run multiple times (due to reference 
+  loops). Before returning, @dispose should chain up to the @dispose method 
+  of the parent class.
+@finalize: instance finalization function, should finish the finalization of 
+  the instance begun in @dispose and chain up to the @finalize method of the 
+  parent class.
+@dispatch_properties_changed: emits property change notification for a bunch
+  of properties. Overriding @dispatch_properties_changed should be rarely 
+  needed.
+@notify: the class closure for the notify signal
 
 <!-- ##### STRUCT GObjectConstructParam ##### -->
 <para>
index f86ebdd38fda6abce086bb0b596754cba4bddbdf..9cd33e123334930c2e9b7bc96403807f8d823d8e 100644 (file)
@@ -98,6 +98,7 @@ struct _GParamSpecClass
   gint          (*values_cmp)           (GParamSpec   *pspec,
                                         const GValue *value1,
                                         const GValue *value2);
+  /*< private >*/
   gpointer       dummy[4];
 };
 struct _GParameter /* auxillary structure for _setv() variants */