diff --git a/ChangeLog b/ChangeLog
index b21c30fda..86deee291 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2007-12-17  Emmanuele Bassi  <ebassi@openedhand.com>
+
+	* clutter/clutter-actor.c: Clarify the set_clip() method
+	documentation, pointing out that the clip area origin is
+	always the top-left corner of an actor.
+
 2007-12-15  Emmanuele Bassi  <ebassi@openedhand.com>
 
 	* clutter/clutter-actor.c:
diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c
index 601d502a8..afc3c3362 100644
--- a/clutter/clutter-actor.c
+++ b/clutter/clutter-actor.c
@@ -3336,7 +3336,9 @@ clutter_actor_get_rotation (ClutterActor      *self,
  * @width: Width of the clip rectangle
  * @height: Height of the clip rectangle
  *
- * Sets clip area in pixels for @self.
+ * Sets clip area in pixels for @self. The clip area is always computed
+ * from the upper left corner of the actor, even if the anchor point is
+ * set otherwise.
  */
 void
 clutter_actor_set_clip (ClutterActor *self,