[glib] gfile: Be clear about freeing GFile objects

[Javier JardÃn <jjardon src gnome org>]

commit 6d05f684eb0193f7b272cbbe42cd7e72eb0f5174
Author: Javier JardÃn <jjardon gnome org>
Date:   Thu Sep 29 20:00:16 2011 +0100

    gfile: Be clear about freeing GFile objects

 gio/gfile.c |    9 ++++++---
 1 files changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gio/gfile.c b/gio/gfile.c
index 48a0652..dcd7433 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -5855,7 +5855,8 @@ g_file_real_copy_finish (GFile        *file,
  * fails, but the returned object might not support any I/O
  * operation if @path is malformed.
  * 
- * Returns: (transfer full): a new #GFile for the given @path. 
+ * Returns: (transfer full): a new #GFile for the given @path.
+ *   Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_new_for_path (const char *path)
@@ -5874,7 +5875,8 @@ g_file_new_for_path (const char *path)
  * operation if @uri is malformed or if the uri type is 
  * not supported.
  * 
- * Returns: (transfer full): a #GFile for the given @uri.
+ * Returns: (transfer full): a new #GFile for the given @uri.
+ *   Free the returned object with g_object_unref().
  **/ 
 GFile *
 g_file_new_for_uri (const char *uri)
@@ -5938,7 +5940,8 @@ has_valid_scheme (const char *uri)
  * This operation never fails, but the returned object might not support any
  * I/O operation if @arg points to a malformed path.
  *
- * Returns: (transfer full): a new #GFile. 
+ * Returns: (transfer full): a new #GFile.
+ *  Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_new_for_commandline_arg (const char *arg)