From 0a20d4cbe4372612c9c2035ffd515cd0f87db9d4 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Wed, 9 Jul 2008 04:26:47 +0000
Subject: [PATCH] Doc improvement

svn path=/trunk/; revision=7173
---
 gio/ChangeLog        |  2 ++
 gio/gfile.c          | 22 ++++++++++++++--------
 gio/gvolumemonitor.c |  2 ++
 3 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/gio/ChangeLog b/gio/ChangeLog
index 6e39be5..68e3b9b 100644
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,5 +1,7 @@
 2008-07-08  Matthias Clasen  <mclasen@redhat.com>
 
+	* gvolumemonitor.c:
+	* gfile.c:
 	* gvolume.c:
 	* gmount.c: Documentation improvements.
 
diff --git a/gio/gfile.c b/gio/gfile.c
index 7ba6108..ec8c58a 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -604,6 +604,7 @@ g_file_equal (GFile *file1,
  * 
  * Returns: a #GFile structure to the parent of the given
  *     #GFile or %NULL if there is no parent. 
+ *     Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_get_parent (GFile *file)
@@ -631,6 +632,7 @@ g_file_get_parent (GFile *file)
  * This call does no blocking i/o.
  * 
  * Returns: a #GFile to a child specified by @name.
+ *     Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_get_child (GFile      *file,
@@ -658,6 +660,7 @@ g_file_get_child (GFile      *file,
  * 
  * Returns: a #GFile to the specified child, or 
  *     %NULL if the display name couldn't be converted.  
+ *     Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_get_child_for_display_name (GFile      *file,
@@ -679,14 +682,16 @@ g_file_get_child_for_display_name (GFile      *file,
  * @file: input #GFile.
  * @prefix: input #GFile.
  * 
- * Checks whether @file has the prefix specified by @prefix. In other word, if the
- * names of inital elements of @file<!-- -->s pathname match @prefix.
+ * Checks whether @file has the prefix specified by @prefix. In other word, 
+ * if the names of inital elements of @file<!-- -->s pathname match @prefix.
  * 
- * This call does no i/o, as it works purely on names. As such it can sometimes
- * return %FALSE even if @file is inside a @prefix (from a filesystem point of view),
- * because the prefix of @file is an alias of @prefix.
+ * This call does no i/o, as it works purely on names. As such it can 
+ * sometimes return %FALSE even if @file is inside a @prefix (from a 
+ * filesystem point of view), because the prefix of @file is an alias 
+ * of @prefix.
  *
- * Returns:  %TRUE if the @files's parent, grandparent, etc is @prefix. %FALSE otherwise.
+ * Returns:  %TRUE if the @files's parent, grandparent, etc is @prefix. 
+ *     %FALSE otherwise.
  **/
 gboolean
 g_file_has_prefix (GFile *file,
@@ -717,8 +722,8 @@ g_file_has_prefix (GFile *file,
  * This call does no blocking i/o.
  * 
  * Returns: string with the relative path from @descendant 
- *     to @parent, or %NULL if @descendant doesn't have @parent as prefix. The returned string should be freed with 
- *     g_free() when no longer needed.
+ *     to @parent, or %NULL if @descendant doesn't have @parent as prefix. 
+ *     The returned string should be freed with g_free() when no longer needed.
  **/
 char *
 g_file_get_relative_path (GFile *parent,
@@ -748,6 +753,7 @@ g_file_get_relative_path (GFile *parent,
  * 
  * Returns: #GFile to the resolved path. %NULL if @relative_path 
  *     is %NULL or if @file is invalid.
+ *     Free the returned object with g_object_unref().
  **/
 GFile *
 g_file_resolve_relative_path (GFile      *file,
diff --git a/gio/gvolumemonitor.c b/gio/gvolumemonitor.c
index e14af16..4c3aeea 100644
--- a/gio/gvolumemonitor.c
+++ b/gio/gvolumemonitor.c
@@ -332,6 +332,7 @@ g_volume_monitor_get_mounts (GVolumeMonitor *volume_monitor)
  * Finds a #GVolume object by it's UUID (see g_volume_get_uuid())
  * 
  * Returns: a #GVolume or %NULL if no such volume is available.
+ *     Free the returned object with g_object_unref().
  **/
 GVolume *
 g_volume_monitor_get_volume_for_uuid (GVolumeMonitor *volume_monitor, 
@@ -355,6 +356,7 @@ g_volume_monitor_get_volume_for_uuid (GVolumeMonitor *volume_monitor,
  * Finds a #GMount object by it's UUID (see g_mount_get_uuid())
  * 
  * Returns: a #GMount or %NULL if no such mount is available.
+ *     Free the returned object with g_object_unref().
  **/
 GMount *
 g_volume_monitor_get_mount_for_uuid (GVolumeMonitor *volume_monitor, 
-- 
2.7.4