Expand the docs of g_object_class_install_property. Proposed by Maciej

* gobject.c: Expand the docs of g_object_class_install_property.
Proposed by Maciej Piechotka

svn path=/trunk/; revision=7642

diff --git a/gobject/ChangeLog b/gobject/ChangeLog
index 21888c0..a6eacae 100644 (file)
--- a/gobject/ChangeLog
+++ b/gobject/ChangeLog
@@ -1,3 +1,10 @@
+2008-11-03  Matthias Clasen <mclasen@redhat.com>
+
+       Bug 555935 – Clear the mechanism of overwriting properties
+
+       * gobject.c: Expand the docs of g_object_class_install_property.
+       Proposed by Maciej Piechotka
+
 2008-10-16  Matthias Clasen <mclasen@redhat.com>
 
        * === Released 2.19.0 ===

diff --git a/gobject/gobject.c b/gobject/gobject.c
index a9b16de..607a0ea 100644 (file)
--- a/gobject/gobject.c
+++ b/gobject/gobject.c
@@ -397,6 +397,10 @@ install_property_internal (GType       g_type,
  * @pspec: the #GParamSpec for the new property
  *
  * Installs a new property. This is usually done in the class initializer.
+ *
+ * Note that it is possible to redefine a property in a derived class,
+ * by installing a property with the same name. This can be useful at times,
+ * e.g. to change the range of allowed values or the default value.
  */
 void
 g_object_class_install_property (GObjectClass *class,