docs: Clarify actor map and unmap methods
authorEmmanuele Bassi <ebassi@linux.intel.com>
Thu, 2 Feb 2012 11:18:00 +0000 (11:18 +0000)
committerEmmanuele Bassi <ebassi@linux.intel.com>
Thu, 2 Feb 2012 11:18:00 +0000 (11:18 +0000)
commit9872d7eb1b31112f3f72855ef00334f39cdb949f
tree843782fde8b33b0b3b2f6fe3a3ea24ed25322d75
parent242de47c032eb750bd825a1d26b4b911e80527b9
docs: Clarify actor map and unmap methods

ClutterActor stopped requiring to override the map and unmap virtual
functions some time ago.

Now that ClutterActor implements the Container interface, overriding map
and unmap to control the MAPPED state of the children is pretty much
going to be a source of bugs and misunderstandings.

Plus, the ordering of the unmap, destroy, dispose, and finalize calls
should be be documented properly.

The documentation should clarify all that.
clutter/clutter-actor.c