docs: Warn users of ClutterGeometry

The Geometry type is an *awful* representation of a integer rectangle,
as it uses unsigned integers for its size, leading to overflow issues
when unioning and intersecting. We have better rectangle types in
Cairo and Clutter, these days.
This commit is contained in:
Emmanuele Bassi 2012-08-09 16:56:19 +01:00
parent 46211a65db
commit f576084277

View File

@ -536,6 +536,10 @@ void clutter_actor_box_set_size (ClutterActorBox *box,
* @height: height of an actor
*
* The rectangle containing an actor's bounding box, measured in pixels.
*
* <warning>You should not use #ClutterGeometry, or operate on its fields
* directly; you should use #cairo_rectangle_int_t or #ClutterRect if you
* need a rectangle type, depending on the precision required.</warning>
*/
struct _ClutterGeometry
{