From f5760842773f9db3b6cca436b921b97b52699171 Mon Sep 17 00:00:00 2001
From: Emmanuele Bassi <ebassi@gnome.org>
Date: Thu, 9 Aug 2012 16:56:19 +0100
Subject: [PATCH] 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.
---
 clutter/clutter-types.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/clutter/clutter-types.h b/clutter/clutter-types.h
index e7ede1452..30205686c 100644
--- a/clutter/clutter-types.h
+++ b/clutter/clutter-types.h
@@ -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
 {