docs: gst: more gobject introspection annotations

[platform/upstream/gstreamer.git] / gst / gstregistry.h

diff --git a/gst/gstregistry.h b/gst/gstregistry.h
index 2f38dcd..9ae9e6c 100644 (file)
--- a/gst/gstregistry.h
+++ b/gst/gstregistry.h
@@ -127,7 +127,7 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
 
 /**
  * gst_default_registry_add_plugin:
- * @plugin: the plugin to add
+ * @plugin: (transfer full): the plugin to add
  *
  * Add the plugin to the default registry.
  * The plugin-added signal will be emitted.
@@ -153,7 +153,8 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
  *
  * Get the list of paths for the default registry.
  *
- * Returns: A Glist of paths as strings. g_list_free after use.
+ * Returns: (transfer container) (element-type char*): a #GList of paths as
+ *     strings. g_list_free() after use.
  */
 #define gst_default_registry_get_path_list() \
   gst_registry_get_path_list (gst_registry_get_default())
@@ -163,7 +164,8 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
  *
  * Get a copy of all plugins registered in the default registry.
  *
- * Returns: a copy of the list. Free after use.
+ * Returns: (transfer full) (element-type Gst.Plugin): a copy of the list.
+ *     Free after use.
  */
 #define gst_default_registry_get_plugin_list() \
   gst_registry_get_plugin_list (gst_registry_get_default())
@@ -175,8 +177,8 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
  *
  * Find the pluginfeature with the given name and type in the default registry.
  *
- * Returns: The pluginfeature with the given name and type or NULL
- * if the plugin was not found.
+ * Returns: (transfer full): the pluginfeature with the given name and type or
+ *    NULL if the plugin was not found.
  */
 #define gst_default_registry_find_feature(name,type) \
   gst_registry_find_feature (gst_registry_get_default(),name,type)
@@ -188,7 +190,8 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
  * Find the plugin with the given name in the default registry.
  * The plugin will be reffed; caller is responsible for unreffing.
  *
- * Returns: The plugin with the given name or NULL if the plugin was not found.
+ * Returns: (transfer full): The plugin with the given name or NULL if the
+ *     plugin was not found.
  */
 #define gst_default_registry_find_plugin(name) \
   gst_registry_find_plugin (gst_registry_get_default(),name)
@@ -204,7 +207,8 @@ gboolean            gst_registry_xml_write_cache    (GstRegistry * registry, const char *lo
  * If the first flag is set, only the first match is
  * returned (as a list with a single object).
  *
- * Returns: a GList of plugin features, gst_plugin_feature_list_free after use.
+ * Returns: (transfer full) (element-type Gst.PluginFeature): a #GList of
+ *     plugin features, gst_plugin_feature_list_free after use.
  */
 #define gst_default_registry_feature_filter(filter,first,user_data) \
   gst_registry_feature_filter (gst_registry_get_default(),filter,first,user_data)