collectpads: Improve docs about 'data' attribute

Adds a reminder to 'data' attribute doc

Fixes #610366

diff --git a/libs/gst/base/gstcollectpads.h b/libs/gst/base/gstcollectpads.h
index f5ced28..a19ce99 100644 (file)
--- a/libs/gst/base/gstcollectpads.h
+++ b/libs/gst/base/gstcollectpads.h
@@ -130,6 +130,8 @@ typedef GstFlowReturn (*GstCollectPadsFunction) (GstCollectPads *pads, gpointer
  * @data: #GList of #GstCollectData managed by this #GstCollectPads.
  *
  * Collectpads object.
+ * Note that @data doesn't contain the complete #GstCollectData list
+ * at all times and should not be used for iterating them.
  */
 struct _GstCollectPads {
   GstObject      object;