From: Edward Hervey <bilboed@bilboed.com>
Date: Thu, 8 Jul 2010 14:24:21 +0000 (+0200)
Subject: utils: Add more details about gst_element_get_compatible_pad
X-Git-Tag: RELEASE-0.10.31~299
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=5b40ebbceb01c0a7e88ac0ec1784de9fb5468b60;p=platform%2Fupstream%2Fgstreamer.git

utils: Add more details about gst_element_get_compatible_pad
---

diff --git a/gst/gstutils.c b/gst/gstutils.c
index 456d53b..7b3ac98 100644
--- a/gst/gstutils.c
+++ b/gst/gstutils.c
@@ -1090,6 +1090,10 @@ gst_pad_check_link (GstPad * srcpad, GstPad * sinkpad)
  * guaranteed that linking the pads will work, though it should work in most
  * cases.
  *
+ * This function will first attempt to find a compatible unlinked ALWAYS pad,
+ * and if none can be found, it will request a compatible REQUEST pad by looking
+ * at the templates of @element.
+ *
  * Returns: the #GstPad to which a link can be made, or %NULL if one cannot be
  * found. gst_object_unref() after usage.
  */