caps: small docs update

[platform/upstream/gstreamer.git] / gst / gsttypefindfactory.c

diff --git a/gst/gsttypefindfactory.c b/gst/gsttypefindfactory.c
index 1ea013a..aca0698 100644 (file)
--- a/gst/gsttypefindfactory.c
+++ b/gst/gsttypefindfactory.c
@@ -91,14 +91,13 @@ GST_DEBUG_CATEGORY (type_find_debug);
 
 static void gst_type_find_factory_dispose (GObject * object);
 
-static GstPluginFeatureClass *parent_class = NULL;
-
 #define _do_init \
 { \
   GST_DEBUG_CATEGORY_INIT (type_find_debug, "GST_TYPEFIND", \
       GST_DEBUG_FG_GREEN, "typefinding subsystem"); \
 }
 
+#define gst_type_find_factory_parent_class parent_class
 G_DEFINE_TYPE_WITH_CODE (GstTypeFindFactory, gst_type_find_factory,
     GST_TYPE_PLUGIN_FEATURE, _do_init);
 
@@ -107,8 +106,6 @@ gst_type_find_factory_class_init (GstTypeFindFactoryClass * klass)
 {
   GObjectClass *object_class = G_OBJECT_CLASS (klass);
 
-  parent_class = g_type_class_peek_parent (klass);
-
   object_class->dispose = gst_type_find_factory_dispose;
 }
 
@@ -144,14 +141,20 @@ gst_type_find_factory_dispose (GObject * object)
  * gst_type_find_factory_get_list:
  *
  * Gets the list of all registered typefind factories. You must free the
- * list using gst_plugin_feature_list_free.
+ * list using gst_plugin_feature_list_free().
+ *
+ * The returned factories are sorted by highest rank first, and then by
+ * factory name. (behaviour change since 0.10.26)
+ *
+ * Free-function: gst_plugin_feature_list_free
  *
- * Returns: the list of all registered #GstTypeFindFactory.
+ * Returns: (transfer full) (element-type Gst.TypeFindFactory): the list of all
+ *     registered #GstTypeFindFactory.
  */
 GList *
 gst_type_find_factory_get_list (void)
 {
-  return gst_registry_get_feature_list (gst_registry_get_default (),
+  return gst_registry_get_feature_list (gst_registry_get (),
       GST_TYPE_TYPE_FIND_FACTORY);
 }
 
@@ -161,7 +164,7 @@ gst_type_find_factory_get_list (void)
  *
  * Gets the #GstCaps associated with a typefind factory.
  *
- * Returns: The #GstCaps associated with this factory
+ * Returns: (transfer none): the #GstCaps associated with this factory
  */
 GstCaps *
 gst_type_find_factory_get_caps (GstTypeFindFactory * factory)
@@ -177,10 +180,11 @@ gst_type_find_factory_get_caps (GstTypeFindFactory * factory)
  *
  * Gets the extensions associated with a #GstTypeFindFactory. The returned
  * array should not be changed. If you need to change stuff in it, you should
- * copy it using g_stdupv().  This function may return NULL to indicate
+ * copy it using g_strdupv().  This function may return NULL to indicate
  * a 0-length list.
  *
- * Returns: a NULL-terminated array of extensions associated with this factory
+ * Returns: (transfer none) (array zero-terminated=1) (element-type utf8): a
+ *     NULL-terminated array of extensions associated with this factory
  */
 gchar **
 gst_type_find_factory_get_extensions (GstTypeFindFactory * factory)
@@ -193,8 +197,8 @@ gst_type_find_factory_get_extensions (GstTypeFindFactory * factory)
 /**
  * gst_type_find_factory_call_function:
  * @factory: A #GstTypeFindFactory
- * @find: A properly setup #GstTypeFind entry. The get_data and suggest_type
- *        members must be set.
+ * @find: (transfer none): a properly setup #GstTypeFind entry. The get_data
+ *     and suggest_type members must be set.
  *
  * Calls the #GstTypeFindFunction associated with this factory.
  */