Doc: clarify set_property() vfunc

Implementations "don't need to ...". It was not clear what happen
if they do it all the same.

https://bugzilla.gnome.org/show_bug.cgi?id=695887
This commit is contained in:
Sébastien Wilmet 2013-03-14 23:24:18 +01:00
parent e569079414
commit e3c2d03092

View File

@ -257,9 +257,10 @@ struct _GObject
* @constructor of the parent class. Overriding @constructor should be rarely
* needed, e.g. to handle construct properties, or to implement singletons.
* @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.
* overridden for every type with properties. If implementations of
* @set_property don't emit property change notification explicitly, this will
* be done implicitly by the type system. However, if the notify signal is
* emitted explicitly, the type system will not emit it a second time.
* @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