From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Wed, 11 Jun 2008 16:17:56 +0000 (+0000)
Subject: Improve the docs
X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=12fe21210efd2669b2788066c85eb268ca718297;p=dana%2Fcg-glib.git

Improve the docs

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

diff --git a/ChangeLog b/ChangeLog
index 9135ccfd..e8cecfcd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2008-06-11  Matthias Clasen  <mclasen@redhat.com>
+
+	Bug 455215 – g_get_user_special_dir: no reference about
+	G_USER_DIRECTORY_DOWNLOAD fallback to $HOME/Desktop if 
+	xdg-user-dirs is not in use
+
+	* glib/gutils.c (g_get_user_special_dir): Improve the docs.
+	Proposed by Luca Ferretti
+
 2008-06-11  Matthias Clasen  <mclasen@redhat.com>
 
 	Bug 498732 – g_key_file_to_data cannot fail
diff --git a/glib/gutils.c b/glib/gutils.c
index 4654388f..b2b7dc15 100644
--- a/glib/gutils.c
+++ b/glib/gutils.c
@@ -2446,6 +2446,9 @@ load_user_special_dirs (void)
  * Returns the full path of a special directory using its logical id.
  *
  * On Unix this is done using the XDG special user directories.
+ * For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP
+ * falls back to <filename>$HOME/Desktop</filename> when XDG special
+ * user directories have not been set up. 
  *
  * Depending on the platform, the user might be able to change the path
  * of the special directory without requiring the session to restart; GLib