appinfo: update docs for API addition

diff --git a/docs/reference/gio/gio-sections.txt b/docs/reference/gio/gio-sections.txt
index 1daec67..cd515bf 100644 (file)
--- a/docs/reference/gio/gio-sections.txt
+++ b/docs/reference/gio/gio-sections.txt
@@ -1257,6 +1257,8 @@ g_app_info_get_all
 g_app_info_get_all_for_type
 g_app_info_get_default_for_type
 g_app_info_get_default_for_uri_scheme
+g_app_info_get_fallback_for_type
+g_app_info_get_recommended_for_type
 g_app_info_launch_default_for_uri
 g_app_launch_context_get_display
 g_app_launch_context_get_startup_notify_id

diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c
index b98e6ac..dfaefc3 100644 (file)
--- a/gio/gdesktopappinfo.c
+++ b/gio/gdesktopappinfo.c
@@ -1723,6 +1723,17 @@ app_info_in_list (GAppInfo *info,
   return FALSE;
 }
 
+/**
+ * g_app_info_get_recommended_for_type:
+ * @content_type: the content type to find a #GAppInfo for
+ * 
+ * Gets a list of recommended #GAppInfo<!-- -->s for a given content type, i.e.
+ * those applications which claim to support the given content type exactly, and
+ * not by MIME type subclassing.
+ *
+ * Returns: (element-type GAppInfo) (transfer full): #GList of #GAppInfo<!-- -->s for given @content_type
+ *    or %NULL on error.
+ **/
 GList *
 g_app_info_get_recommended_for_type (const gchar *content_type)
 {
@@ -1755,6 +1766,17 @@ g_app_info_get_recommended_for_type (const gchar *content_type)
   return g_list_reverse (infos);
 }
 
+/**
+ * g_app_info_get_fallback_for_type:
+ * @content_type: the content type to find a #GAppInfo for
+ * 
+ * Gets a list of fallback #GAppInfo<!-- -->s for a given content type, i.e.
+ * those applications which claim to support the given content type by MIME type
+ * subclassing and not directly.
+ *
+ * Returns: (element-type GAppInfo) (transfer full): #GList of #GAppInfo<!-- -->s for given @content_type
+ *    or %NULL on error.
+ **/
 GList *
 g_app_info_get_fallback_for_type (const gchar *content_type)
 {

diff --git a/gio/gio.symbols b/gio/gio.symbols
index 90ea290..6e2f232 100644 (file)
--- a/gio/gio.symbols
+++ b/gio/gio.symbols
@@ -103,6 +103,8 @@ g_app_info_get_all
 g_app_info_get_all_for_type
 g_app_info_get_default_for_type
 g_app_info_get_default_for_uri_scheme
+g_app_info_get_fallback_for_type
+g_app_info_get_recommended_for_type
 g_app_info_reset_type_associations
 #endif
 #endif