element: Clarify docs about gst_element_get_request_pad() and remove deprecation part

This function is not really pad or slow for the common case of requesting a
pad with the name of the template. It is only slower if you to name your pads
directly instead of letting the element handle it.

Also there's no reason to deprecate it in favor of a more complicated function
for the common case.
This commit is contained in:
Sebastian Dröge 2014-08-13 12:37:08 +03:00
parent ee662efdd1
commit 82e01491a0

View file

@ -975,8 +975,9 @@ _gst_element_request_pad (GstElement * element, GstPadTemplate * templ,
* retrieves request pads. The pad should be released with
* gst_element_release_request_pad().
*
* This method is slow and will be deprecated in the future. New code should
* use gst_element_request_pad() with the requested template.
* This method is slower than manually getting the pad template and calling
* gst_element_request_pad() if the pads should have a specific name (e.g.
* @name is "src_1" instead of "src_%u").
*
* Returns: (transfer full) (nullable): requested #GstPad if found,
* otherwise %NULL. Release after usage.