docs: give a practical example for the gst_object_has_anchestor

diff --git a/gst/gstobject.c b/gst/gstobject.c
index 7cdb5dc5e00eb6c007fb431f3982822f65efd039..dabb894e038c20ae9d0ee007667370563db43752 100644 (file)
--- 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.
  *