mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-04-26 06:54:49 +00:00
Code Issues 1 Projects Releases Wiki Activity

gst/gstelement.c: Small documentation fixes.

Browse source 
Original commit message from CVS:
* gst/gstelement.c: (gst_element_set_state_func):
Small documentation fixes.
This commit is contained in:
Wim Taymans 2006-12-15 15:39:28 +00:00
parent a075063c1b
commit 06651f5547
2 changed files with 16 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

5
ChangeLog
View file

@ -1,3 +1,8 @@
2006-12-15 Wim Taymans <wim@fluendo.com>
* gst/gstelement.c: (gst_element_set_state_func):
Small documentation fixes.
2006-12-15 Wim Taymans <wim@fluendo.com> 2006-12-15 Wim Taymans <wim@fluendo.com>
* docs/design/draft-latency.txt: * docs/design/draft-latency.txt:

21
gst/gstelement.c
View file

@ -261,7 +261,7 @@ gst_element_init (GstElement * element)
* @object: a #GObject that signalled the error. * @object: a #GObject that signalled the error.
* @orig: the #GstObject that initiated the error. * @orig: the #GstObject that initiated the error.
* @error: the GError. * @error: the GError.
* @debug: an additional debug information string, or NULL. * @debug: an additional debug information string, or %NULL.
* *
* A default error signal callback to attach to an element. * A default error signal callback to attach to an element.
* The user data passed to the g_signal_connect is ignored. * The user data passed to the g_signal_connect is ignored.
@ -367,7 +367,7 @@ gst_element_provides_clock (GstElement * element)
* <note>An element is only required to provide a clock in the PAUSED * <note>An element is only required to provide a clock in the PAUSED
* state. Some elements can provide a clock in other states.</note> * state. Some elements can provide a clock in other states.</note>
* *
* Returns: the GstClock provided by the element or NULL * Returns: the GstClock provided by the element or %NULL
* if no clock could be provided. Unref after usage. * if no clock could be provided. Unref after usage.
* *
* MT safe. * MT safe.
@ -557,7 +557,7 @@ gst_element_set_index (GstElement * element, GstIndex * index)
* *
* Gets the index from the element. * Gets the index from the element.
* *
* Returns: a #GstIndex or NULL when no index was set on the * Returns: a #GstIndex or %NULL when no index was set on the
* element. unref after usage. * element. unref after usage.
* *
* MT safe. * MT safe.
@ -819,7 +819,7 @@ pad_compare_name (GstPad * pad1, const gchar * name)
* Retrieves a pad from @element by name. This version only retrieves * Retrieves a pad from @element by name. This version only retrieves
* already-existing (i.e. 'static') pads. * already-existing (i.e. 'static') pads.
* *
* Returns: the requested #GstPad if found, otherwise NULL. unref after * Returns: the requested #GstPad if found, otherwise %NULL. unref after
* usage. * usage.
* *
* MT safe. * MT safe.
@ -880,7 +880,7 @@ gst_element_request_pad (GstElement * element, GstPadTemplate * templ,
* request pads. The pad should be released with * request pads. The pad should be released with
* gst_element_release_request_pad(). * gst_element_release_request_pad().
* *
* Returns: requested #GstPad if found, otherwise NULL. Release after usage. * Returns: requested #GstPad if found, otherwise %NULL. Release after usage.
*/ */
GstPad * GstPad *
gst_element_get_request_pad (GstElement * element, const gchar * name) gst_element_get_request_pad (GstElement * element, const gchar * name)
@ -1133,7 +1133,7 @@ gst_element_class_get_pad_template_list (GstElementClass * element_class)
* that has subclasses, make sure to pass the g_class parameter of the * that has subclasses, make sure to pass the g_class parameter of the
* #GInstanceInitFunc here.</note> * #GInstanceInitFunc here.</note>
* *
* Returns: the #GstPadTemplate with the given name, or NULL if none was found. * Returns: the #GstPadTemplate with the given name, or %NULL if none was found.
* No unreferencing is necessary. * No unreferencing is necessary.
*/ */
GstPadTemplate * GstPadTemplate *
@ -1457,11 +1457,11 @@ no_bus:
/** /**
* _gst_element_error_printf: * _gst_element_error_printf:
* @format: the printf-like format to use, or NULL * @format: the printf-like format to use, or %NULL
* *
* This function is only used internally by the gst_element_error() macro. * This function is only used internally by the gst_element_error() macro.
* *
* Returns: a newly allocated string, or NULL if the format was NULL or "" * Returns: a newly allocated string, or %NULL if the format was %NULL or ""
* *
* MT safe. * MT safe.
*/ */
@ -1489,9 +1489,9 @@ _gst_element_error_printf (const gchar * format, ...)
* @domain: the GStreamer GError domain this message belongs to * @domain: the GStreamer GError domain this message belongs to
* @code: the GError code belonging to the domain * @code: the GError code belonging to the domain
* @text: an allocated text string to be used as a replacement for the * @text: an allocated text string to be used as a replacement for the
* default message connected to code, or NULL * default message connected to code, or %NULL
* @debug: an allocated debug message to be used as a replacement for the * @debug: an allocated debug message to be used as a replacement for the
* default debugging information, or NULL * default debugging information, or %NULL
* @file: the source code file where the error was generated * @file: the source code file where the error was generated
* @function: the source code function where the error was generated * @function: the source code function where the error was generated
* @line: the source code line where the error was generated * @line: the source code line where the error was generated
@ -2141,6 +2141,7 @@ gst_element_set_state_func (GstElement * element, GstState state)
current = GST_STATE (element); current = GST_STATE (element);
next = GST_STATE_NEXT (element); next = GST_STATE_NEXT (element);
old_pending = GST_STATE_PENDING (element); old_pending = GST_STATE_PENDING (element);
/* increment state cookie so that we can track each state change */
element->state_cookie++; element->state_cookie++;
/* this is the (new) state we should go to */ /* this is the (new) state we should go to */