From: Tim-Philipp Müller Date: Fri, 10 Aug 2012 16:08:31 +0000 (+0100) Subject: docs: expand GstDiscoverer::discovered signal docs a little X-Git-Tag: RELEASE-0.11.94~149 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=26ec6d49a176c092978c366dde36129e43a77442;p=platform%2Fupstream%2Fgst-plugins-base.git docs: expand GstDiscoverer::discovered signal docs a little --- diff --git a/gst-libs/gst/pbutils/gstdiscoverer.c b/gst-libs/gst/pbutils/gstdiscoverer.c index b91b284..d3f861f 100644 --- a/gst-libs/gst/pbutils/gstdiscoverer.c +++ b/gst-libs/gst/pbutils/gstdiscoverer.c @@ -237,9 +237,15 @@ gst_discoverer_class_init (GstDiscovererClass * klass) * @discoverer: the #GstDiscoverer * @info: the results #GstDiscovererInfo * @error: (type GLib.Error): #GError, which will be non-NULL if an error - * occurred during discovery + * occurred during discovery. You must not + * free this #GError, it will be freed by + * the discoverer. * - * Will be emitted when all information on a URI could be discovered. + * Will be emitted when all information on a URI could be discovered, or + * an error ocurred. + * + * When an error occurs, @info might still contain some partial information, + * depending on the circumstances of the error. */ gst_discoverer_signals[SIGNAL_DISCOVERED] = g_signal_new ("discovered", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST, @@ -264,8 +270,7 @@ gst_discoverer_class_init (GstDiscovererClass * klass) gst_discoverer_signals[SIGNAL_SOURCE_SETUP] = g_signal_new ("source-setup", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstDiscovererClass, source_setup), - NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 1, - GST_TYPE_ELEMENT); + NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 1, GST_TYPE_ELEMENT); } static void