Add docs

svn path=/trunk/; revision=6410

diff --git a/gio/gfile.c b/gio/gfile.c
index 0dec35aa8711187b63790a4f5352290a1c7d8a89..e54f5b77e982505bbfb04bfdd05c75a9def7aefa 100644 (file)
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -4572,6 +4572,22 @@ g_file_mount_enclosing_volume_finish (GFile         *location,
  *   Utility functions                      *
  ********************************************/
 
+/**
+ * g_file_query_default_handler:
+ * @file: a #GFile to open.
+ * @cancellable: optional #GCancellable object, %NULL to ignore.
+ * @error: a #GError, or %NULL
+ *
+ * Returns the #GAppInfo that is registered as the default
+ * application to handle the file specified bu @file.
+ *
+ * If @cancellable is not %NULL, then the operation can be cancelled by
+ * triggering the cancellable object from another thread. If the operation
+ * was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. 
+ *
+ * Returns: a #GAppInfo if the handle was found, %NULL if there were errors.
+ * When you are done with it, release it with g_object_unref()
+ **/
 GAppInfo *
 g_file_query_default_handler (GFile                  *file,
                              GCancellable           *cancellable,