diff --git a/clutter/clutter-animatable.c b/clutter/clutter-animatable.c
index f5400e3e7..413b2eb35 100644
--- a/clutter/clutter-animatable.c
+++ b/clutter/clutter-animatable.c
@@ -224,6 +224,31 @@ clutter_animatable_set_final_state (ClutterAnimatable *animatable,
     g_object_set_property (G_OBJECT (animatable), property_name, value);
 }
 
+/**
+ * clutter_animatable_interpolate_value:
+ * @animatable: a #ClutterAnimatable
+ * @property_name: the name of the property to interpolate
+ * @interval: a #ClutterInterval with the animation range
+ * @progress: the progress to use to interpolate between the
+ *   initial and final values of the @interval
+ * @value: (out): return location for an initialized #GValue
+ *   using the same type of the @interval
+ *
+ * Asks a #ClutterAnimatable implementation to interpolate a
+ * a named property between the initial and final values of
+ * a #ClutterInterval, using @progress as the interpolation
+ * value, and store the result inside @value.
+ *
+ * This function should be used for every property animation
+ * involving #ClutterAnimatable<!-- -->s.
+ *
+ * This function replaces clutter_animatable_animate_property().
+ *
+ * Return value: %TRUE if the interpolation was successful,
+ *   and %FALSE otherwise
+ *
+ * Since: 1.8
+ */
 gboolean
 clutter_animatable_interpolate_value (ClutterAnimatable *animatable,
                                       const gchar       *property_name,
diff --git a/doc/reference/clutter/clutter-sections.txt b/doc/reference/clutter/clutter-sections.txt
index 21e4da270..2e6765a10 100644
--- a/doc/reference/clutter/clutter-sections.txt
+++ b/doc/reference/clutter/clutter-sections.txt
@@ -1883,6 +1883,7 @@ clutter_animatable_animate_property
 clutter_animatable_find_property
 clutter_animatable_get_initial_state
 clutter_animatable_set_final_state
+clutter_animatable_interpolate_property
 
 <SUBSECTION Standard>
 CLUTTER_TYPE_ANIMATABLE