From 911af13b5c256e120e1538b5c15b778a53c930c2 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Sebastian=20Dr=C3=B6ge?= <sebastian@centricular.com>
Date: Wed, 6 Nov 2013 18:41:10 +0100
Subject: [PATCH] collectpads: Update documentation for flushing seek handling

---
 libs/gst/base/gstcollectpads.c | 26 +++++++++++++++++++++++++-
 libs/gst/base/gstcollectpads.h |  2 +-
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/libs/gst/base/gstcollectpads.c b/libs/gst/base/gstcollectpads.c
index 431de7d..40ebf90 100644
--- a/libs/gst/base/gstcollectpads.c
+++ b/libs/gst/base/gstcollectpads.c
@@ -531,7 +531,7 @@ gst_collect_pads_clip_running_time (GstCollectPads * pads,
   return GST_FLOW_OK;
 }
 
- /**
+/**
  * gst_collect_pads_set_clip_function:
  * @pads: the collectpads to use
  * @clipfunc: clip function to install
@@ -551,6 +551,18 @@ gst_collect_pads_set_clip_function (GstCollectPads * pads,
   pads->priv->clip_user_data = user_data;
 }
 
+/**
+ * gst_collect_pads_set_flush_function:
+ * @pads: the collectpads to use
+ * @func: flush function to install
+ * @user_data: user data to pass to @func
+ *
+ * Install a flush function that is called when the internal
+ * state of all pads should be flushed as part of flushing seek
+ * handling. See #GstCollectPadsFlushFunction for more info.
+ *
+ * Since: 1.4
+ */
 void
 gst_collect_pads_set_flush_function (GstCollectPads * pads,
     GstCollectPadsFlushFunction func, gpointer user_data)
@@ -1865,6 +1877,18 @@ forward_event_to_all_sinkpads (GstPad * srcpad, GstEvent * event)
   return data.result;
 }
 
+/**
+ * gst_collect_pads_src_event_default:
+ * @pads: the collectpads to use
+ * @pad: src #GstPad that received the event
+ * @event: event being processed
+ *
+ * Default GstCollectPads event handling for the src pad of elements.
+ * Elements can chain up to this to let flushing seek event handling
+ * be done by GstCollectPads.
+ *
+ * Since: 1.4
+ */
 gboolean
 gst_collect_pads_src_event_default (GstCollectPads * pads, GstPad * pad,
     GstEvent * event)
diff --git a/libs/gst/base/gstcollectpads.h b/libs/gst/base/gstcollectpads.h
index 8d8128c..87cbb61 100644
--- a/libs/gst/base/gstcollectpads.h
+++ b/libs/gst/base/gstcollectpads.h
@@ -249,7 +249,7 @@ typedef GstFlowReturn (*GstCollectPadsClipFunction) (GstCollectPads *pads, GstCo
  * @pads object. It is therefore not necessary to call
  * gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function.
  *
- * Since: FIXME
+ * Since: 1.4
  */
 typedef void (*GstCollectPadsFlushFunction) (GstCollectPads *pads, gpointer user_data);
 
-- 
2.7.4