diff --git a/gst/gstobject.c b/gst/gstobject.c
index 7cdb5dc5e0..dabb894e03 100644
--- a/gst/gstobject.c
+++ b/gst/gstobject.c
@@ -921,7 +921,7 @@ gst_object_unparent (GstObject * object)
  * @ancestor: a #GstObject to check as ancestor
  *
  * Check if @object has an ancestor @ancestor somewhere up in
- * the hierarchy.
+ * the hierarchy. One can e.g. check if a #GstElement is inside a #GstPipeline.
  *
  * Returns: TRUE if @ancestor is an ancestor of @object.
  *