diff --git a/clutter/clutter-pan-action.c b/clutter/clutter-pan-action.c
index 8aa728131..489c867d5 100644
--- a/clutter/clutter-pan-action.c
+++ b/clutter/clutter-pan-action.c
@@ -522,8 +522,8 @@ clutter_pan_action_class_init (ClutterPanActionClass *klass)
    * interpolation phase of the pan, after the drag has ended and
    * the :interpolate property was set to %TRUE.
    *
-   * Return value: TRUE if the pan action has been handled by one of
-   * the listener or %FALSE to continue the emission.
+   * Return value: %TRUE if the pan should continue, and %FALSE if
+   *   the pan should be cancelled.
    *
    * Since: 1.12
    */
diff --git a/clutter/clutter-zoom-action.c b/clutter/clutter-zoom-action.c
index 821a86b2d..f62c96bc0 100644
--- a/clutter/clutter-zoom-action.c
+++ b/clutter/clutter-zoom-action.c
@@ -382,8 +382,8 @@ clutter_zoom_action_class_init (ClutterZoomActionClass *klass)
    * this signal and call g_signal_stop_emission_by_name() from within
    * your callback.
    *
-   * Return value: %TRUE if the zoom action has been handled by one of
-   * the listener or %FALSE to continue the emission.
+   * Return value: %TRUE if the zoom should continue, and %FALSE if
+   *   the zoom should be cancelled.
    *
    * Since: 1.12
    */