diff --git a/clutter/clutter-drag-action.c b/clutter/clutter-drag-action.c
index cf3760097..c7b21dd35 100644
--- a/clutter/clutter-drag-action.c
+++ b/clutter/clutter-drag-action.c
@@ -54,6 +54,20 @@
  * parented and exist between the emission of #ClutterDragAction::drag-begin
  * and #ClutterDragAction::drag-end.
  *
+ * <example id="drag-action-example">
+ *   <title>A simple draggable actor</title>
+ *   <programlisting>
+ * <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../tests/interactive/test-drag.c">
+ *   <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
+ * </xi:include>
+ *   </programlisting>
+ *   <para>The example program above allows dragging the rectangle around
+ *   the stage using a #ClutterDragAction. When pressing the
+ *   <keycap>Shift</keycap> key the actor that is going to be dragged is a
+ *   separate rectangle, and when the drag ends, the original rectangle will
+ *   be animated to the final coordinates.</para>
+ * </example>
+ *
  * #ClutterDragAction is available since Clutter 1.4
  */