isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2025-04-13 13:49:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Update documentation for ::destroy

Browse Source 
The ::destroy signal is meant to be used to break reference cycles on
third party code. The documentation should really make it clear.
This commit is contained in:
Emmanuele Bassi 2011-01-31 12:50:25 +00:00
parent e0580127f8
commit e32253508d
1 changed files with 15 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
clutter/clutter-actor.c
View File

@ -4319,11 +4319,22 @@ clutter_actor_class_init (ClutterActorClass *klass)
/** /**
* ClutterActor::destroy: * ClutterActor::destroy:
* @actor: the object which received the signal * @actor: the #ClutterActor which emitted the signal
* *
* The ::destroy signal is emitted when an actor is destroyed, * The ::destroy signal notifies that all references held on the
* either by direct invocation of clutter_actor_destroy() or * actor which emitted it should be released.
* when the #ClutterGroup that contains the actor is destroyed. *
* The ::destroy signal should be used by all holders of a reference
* on @actor.
*
* This signal might result in the finalization of the #ClutterActor
* if all references are released.
*
* Composite actors and actors implementing the #ClutterContainer
* interface should override the default implementation of the
* class handler of this signal and call clutter_actor_destroy() on
* their children. When overriding the default class handler, it is
* required to chain up to the parent's implementation.
* *
* Since: 0.2 * Since: 0.2
*/ */