From: Alexander Larsson <alexl@src.gnome.org>
Date: Tue, 29 Jan 2008 12:23:24 +0000 (+0000)
Subject: Add docs
X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=75d6d024cd4404794aefd6a98b648bab91a66505;p=dana%2Fcg-glib.git

Add docs

svn path=/trunk/; revision=6410
---

diff --git a/gio/gfile.c b/gio/gfile.c
index 0dec35aa..e54f5b77 100644
--- 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,