[glib/appinfo-splitted] appinfo: update docs for API addition

[Cosimo Cecchi <cosimoc src gnome org>]

commit 8f9e846c97d232543b07ea2485b69472f662aeea
Author: Cosimo Cecchi <cosimoc gnome org>
Date:   Fri Nov 19 10:39:16 2010 +0100

    appinfo: update docs for API addition

 docs/reference/gio/gio-sections.txt |    2 ++
 gio/gdesktopappinfo.c               |   22 ++++++++++++++++++++++
 gio/gio.symbols                     |    2 ++
 3 files changed, 26 insertions(+), 0 deletions(-)
---
diff --git a/docs/reference/gio/gio-sections.txt b/docs/reference/gio/gio-sections.txt
index 1daec67..cd515bf 100644
--- 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..69961e4 100644
--- 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 recommended #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
--- 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