diff --git a/ChangeLog b/ChangeLog
index e5185215b..d9bf0447f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2007-12-09  Emmanuele Bassi  <ebassi@openedhand.com>
+
+	* clutter/clutter-actor.c: Document the values for full
+	transparency and full opacity in the set_opacity()
+	method. (#662)
+
+	* clutter/clutter-behaviour-ellipse.c: Improve consistency
+	in the apidoc.
+
 2007-12-08  Emmanuele Bassi  <ebassi@openedhand.com>
 
 	* configure.ac: Make libtool respect the -s switch of make
diff --git a/clutter/clutter-actor.c b/clutter/clutter-actor.c
index 5637c5d19..9424861f0 100644
--- a/clutter/clutter-actor.c
+++ b/clutter/clutter-actor.c
@@ -2751,7 +2751,8 @@ clutter_actor_get_scale (ClutterActor *self,
  * @self: A #ClutterActor
  * @opacity: New opacity value for actor.
  *
- * Sets the actors opacity, with zero being completely transparent.
+ * Sets the actors opacity, with zero being completely transparent and
+ * 255 (0xff) as fully opaque.
  */
 void
 clutter_actor_set_opacity (ClutterActor *self,
diff --git a/clutter/clutter-behaviour-ellipse.c b/clutter/clutter-behaviour-ellipse.c
index 3ace74afd..a8e8b11a6 100644
--- a/clutter/clutter-behaviour-ellipse.c
+++ b/clutter/clutter-behaviour-ellipse.c
@@ -1164,16 +1164,12 @@ clutter_behaviour_ellipse_set_tiltx (ClutterBehaviourEllipse *self,
 /**
  * clutter_behaviour_ellipse_get_tilt
  * @self: a #ClutterBehaviourEllipse
- * @angle_tilt_x: location for tilt of the elipse around the center in X axis in
- * degrees, or NULL.
- * @angle_tilt_y: location for tilt of the elipse around the center in Y axis in
- * degrees, or NULL.
- * @angle_tilt_z: location for tilt of the elipse around the center in Z axis in
- * degrees, or NULL.
+ * @angle_tilt_x: return location for tilt angle on the X axis, or %NULL.
+ * @angle_tilt_y: return location for tilt angle on the Y axis, or %NULL.
+ * @angle_tilt_z: return location for tilt angle on the Z axis, or %NULL.
  *
  * Gets the tilt of the ellipse around the center in Y axis.
  *
- *
  * Since: 0.4
  */
 void