docs: GstBus: Provide more information for ref/unref during bus watch.

https://bugzilla.gnome.org/show_bug.cgi?id=791588
This commit is contained in:
Umang Jain 2017-12-14 00:03:04 +05:30 committed by Tim-Philipp Müller
parent 9169a2522b
commit 52d2891fe3

View file

@ -974,6 +974,9 @@ gst_bus_add_watch_full_unlocked (GstBus * bus, gint priority,
* from @func. If the watch was added to the default main context it is also
* possible to remove the watch using g_source_remove().
*
* The bus watch will take its own reference to the @bus, so it is safe to unref
* @bus using gst_object_unref() after setting the bus watch.
*
* MT safe.
*
* Returns: The event source id or 0 if @bus already got an event source.
@ -1015,9 +1018,12 @@ gst_bus_add_watch_full (GstBus * bus, gint priority,
* from @func. If the watch was added to the default main context it is also
* possible to remove the watch using g_source_remove().
*
* Returns: The event source id or 0 if @bus already got an event source.
* The bus watch will take its own reference to the @bus, so it is safe to unref
* @bus using gst_object_unref() after setting the bus watch.
*
* MT safe.
*
* Returns: The event source id or 0 if @bus already got an event source.
*/
guint
gst_bus_add_watch (GstBus * bus, GstBusFunc func, gpointer user_data)