From 5b40ebbceb01c0a7e88ac0ec1784de9fb5468b60 Mon Sep 17 00:00:00 2001
From: Edward Hervey <bilboed@bilboed.com>
Date: Thu, 8 Jul 2010 16:24:21 +0200
Subject: [PATCH] utils: Add more details about gst_element_get_compatible_pad

---
 gst/gstutils.c | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/gst/gstutils.c b/gst/gstutils.c
index 456d53bd0c..7b3ac98bbc 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.
  */