docs: improve gst_discoverer_new() docs a bit

This commit is contained in:
Tim-Philipp Müller 2010-10-15 17:23:44 +01:00
parent b5f6f4873b
commit beae0db284

View file

@ -1362,14 +1362,16 @@ gst_discoverer_discover_uri (GstDiscoverer * discoverer, const gchar * uri,
/** /**
* gst_discoverer_new: * gst_discoverer_new:
* @timeout: The timeout to set on the discoverer * @timeout: timeout per file, in nanoseconds. Allowed are values between
* one second (#GST_SECOND) and one hour (3600 * #GST_SECOND)
* @err: a pointer to a #GError. can be %NULL * @err: a pointer to a #GError. can be %NULL
* *
* Creates a new #GstDiscoverer with the provided timeout. * Creates a new #GstDiscoverer with the provided timeout.
* *
* Returns: The new #GstDiscoverer. Free with gst_object_unref() when done. * Returns: The new #GstDiscoverer. Free with gst_object_unref() when done.
* If an error happened when creating the discoverer, @err will be set accordingly * If an error happened when creating the discoverer, @err will be set
* and %NULL will be returned. * accordingly and %NULL will be returned. If @err is set, the caller must
* free it when no longer needed using g_error_free().
* *
* Since: 0.10.31 * Since: 0.10.31
*/ */